
## Overview

Export all your highlights from Screvi as a downloadable ZIP file. Each source (book, article, etc.) becomes a separate file, organized into folders by source type.

## How to Export

1. Go to **Integrations > Export** in the web app
2. Choose your format:
   - **HTML**: Optimized for importing into Apple Notes
   - **Markdown (.md)**: Standard Markdown, great for Obsidian, Notion, or any Markdown editor
3. Click **Export**
4. A ZIP file is downloaded

## What's Included

The export contains:
- One file per source (book, article, tweet thread, etc.)
- Files organized into folders by type (Books, Articles, Tweets, Videos, Documents)
- Highlight text with any personal notes
- Source metadata (title, author)
- Tags associated with each highlight

## Export Formats

### HTML (Apple Notes)

Formatted HTML files designed to look great when imported into Apple Notes. Open the HTML file in Safari and use Share > Notes to add it to Apple Notes.

### Markdown

Standard Markdown files compatible with any Markdown tool:
- Obsidian
- Notion (import Markdown files)
- Bear
- iA Writer
- Any text editor

## Coming Soon

- **Notion Sync**: Direct export to Notion databases
- **Obsidian Sync**: Direct sync with Obsidian vaults

## Public API

For programmatic access to your data, use the [Public API](/docs/api/public-api). It provides JSON access to all your highlights and sources, rate-limited at 100 requests per minute.


How to export your highlights from Screvi in different formats

Exporting Your Highlights


## Article Fails to Save / "Error" Status

When saving an article, you might see it appear with an error status. This usually means Screvi couldn't extract the article content from the URL.

**Common causes:**

- **The site is behind a paywall.** Screvi's server fetches the article from the URL, but paywalled sites block access to the full content.
- **The site blocks automated requests.** Some websites (e.g. Bloomberg, certain news sites) actively block non-browser requests.
- **The page requires JavaScript to render.** Some modern single-page apps don't serve readable HTML to Screvi's fetcher.

**Solution: Save with HTML**

Use the browser extension's **"Save with HTML"** option instead:

1. Open the article in your browser (make sure you can see the full content; log in if it's paywalled)
2. Click the **Screvi extension icon**
3. If the regular save fails, the extension will offer a **"Save with HTML"** option
4. This captures the page content directly from your browser, bypassing server-side restrictions

This works because the extension reads the page as your browser renders it, including any content you have access to through your login or subscription.

---

## Kindle Import Not Finding All Books

Sometimes the Kindle import finishes but seems to be missing books.

**Common causes:**

- **You're on the wrong Amazon region.** If you bought books on amazon.co.uk but you're importing from read.amazon.com, those books won't appear.
- **The import didn't scroll far enough.** For very large libraries, the import needs time to scroll through all books. Don't close the tab.
- **Kindle Unlimited books returned.** If you returned a Kindle Unlimited book, Amazon may remove access to those highlights.

**Solutions:**

- Make sure you're on the correct regional Kindle notebook URL (e.g. `read.amazon.co.uk/notebook` for UK purchases)
- Let the import run to completion. Don't navigate away or close the tab.
- If you have books across multiple Amazon regions, run the import on each regional URL separately

---

## Highlights Appearing as Duplicates

You imported the same source twice and now have duplicate highlights.

**Why this happens:**

Screvi deduplicates based on the source identifier (e.g. Kindle ASIN) and highlight content. Duplicates can appear if:

- The highlight text has slight differences (extra spaces, different line breaks)
- The import came from a different method (e.g. once via extension, once via My Clippings file) and the source wasn't matched

**Solutions:**

- Sometimes duplicates are inevitable, especially when importing from multiple methods. Use **"Move Highlights to Another Source"** to consolidate them: open the duplicate source, tap the menu, and select "Move Highlights to Another Source". All highlights from the duplicate will be moved to the correct source, and the duplicate source will be deleted.
- Use the **AI Cleanup** feature to normalize formatting, then re-import. Screvi's deduplication is more effective on cleaned-up text.
- Delete the duplicate source from the Sources page and re-import using a single method.
- You can also manually delete individual duplicate highlights.

---

## Browser Extension Shows "Not Connected"

The extension icon shows a "Not connected" status and doesn't let you save articles or import highlights.

**Solutions:**

1. Visit [app.screvi.com/login](https://app.screvi.com/login) and log in. The extension connects automatically when you log in to the web app in the same browser.
2. Make sure the extension is enabled in your browser's extension settings (`chrome://extensions` or `about:addons`)
3. Try disabling and re-enabling the extension
4. As a last resort, uninstall and reinstall the extension, then log in again

---

## Email Digest Not Arriving

You've configured a daily email digest but aren't receiving it.

**Common causes:**

- **Not enough content.** The review system requires at least **3 sources** and **20 highlights** to activate. Email digests rely on the review system.
- **Wrong timezone.** The email is sent at your configured time in your configured timezone. Double-check both in Preferences.
- **Spam filter.** The email may be landing in spam or junk.

**Solutions:**

- Check your spam/junk folder and mark Screvi emails as "not spam"
- Go to **Preferences** and verify the time, timezone, and frequency are correct
- Make sure you have at least 3 sources and 20 highlights
- Check that email digests are toggled on

---

## Mobile App Not Syncing

Changes you made on the web aren't showing in the mobile app, or vice versa.

**Solutions:**

- **Pull down to refresh** on any screen in the mobile app
- Check your internet connection
- Go to **Settings** and verify you're logged in to the correct account
- If you made changes offline, they're queued and will sync automatically when connectivity returns. This may take a moment.

---

## iOS Share Extension Not Appearing

You installed the Screvi iOS app but can't find it in the share sheet.

**Solutions:**

1. Open the share sheet in Safari or any app
2. Scroll to the end of the app row and tap **"More"**
3. Find **Screvi** in the list and toggle it on
4. You can also reorder it to appear earlier in the list
5. Make sure you've opened and logged into the main Screvi app at least once after installing

---

## Kobo File Not Found

You connected your Kobo but can't find the `KoboReader.sqlite` file.

**Why:**

The file is inside a **hidden folder** called `.kobo` on your Kobo's drive. Hidden files are not shown by default on most operating systems.

**Solutions:**

- **macOS**: In Finder, press `Cmd + Shift + .` to toggle hidden files, then navigate to the `.kobo` folder
- **Windows**: In File Explorer, go to View > Show > Hidden items, then navigate to the `.kobo` folder
- **Linux**: Press `Ctrl + H` in your file manager to show hidden files

The full path is: `[Kobo Drive]/.kobo/KoboReader.sqlite`

---

## Article Content Looks Wrong or Incomplete

The saved article is missing content, has broken formatting, or shows navigation/menu text.

**Why this happens:**

Screvi extracts article content using a readability parser. Some websites have unusual HTML structures that make it hard to isolate the main content.

**Solutions:**

- Use the **"Save with HTML"** option in the browser extension. This captures exactly what your browser renders, which is usually more complete.
- For PDFs, use the dedicated PDF import (Integrations > PDF Import) instead of saving the PDF URL as an article
- For YouTube videos, use the "Open in Screvi" button on YouTube rather than saving the URL manually

---

## Spaced Repetition Review Not Available

The Review page says you need more content, or the "Start Review" button is disabled.

**Requirements:**

- You need at least **3 sources** and **20 highlights** before the review system activates
- This is intentional. The spaced repetition algorithm needs a minimum pool of highlights to create meaningful review sessions.

**Solution:**

Import more highlights. Check your current count on the **Statistics** page. Once you hit the threshold, the review system activates automatically.

---

## Kindle Highlights Import Is Slow

The Kindle import seems to take a very long time.

**Why:**

The extension needs to scroll through your entire Kindle library on Amazon's website, loading each book's highlights one by one. If you have hundreds of books, this can take several minutes.

**Tips:**

- Don't close or navigate away from the tab during import
- Make sure your internet connection is stable
- The first import takes the longest. Subsequent imports are incremental and only fetch new highlights.
- You can enable **background sync** in the extension settings to run imports automatically every 24 hours without manual intervention


Solutions for the most common problems you might encounter while using Screvi

Common Issues


## Overview

Screvi offers a public REST API for reading your highlights and sources programmatically. Use it to build custom workflows, export data to other tools, or create your own integrations.

## Authentication

All API requests require an API key passed in the `X-API-Key` header.

### Getting Your API Key

1. Go to **Settings > API** in the Screvi web app
2. Copy your API key

### Using the Key

Include the key in every request:

```
GET https://api.screvi.com/api/v1/highlights
X-API-Key: your-api-key-here
```

## Rate Limits

- **100 requests per minute** per API key
- Rate limit headers are included in responses

## Available Endpoints

### Highlights

**GET /api/v1/highlights**

Fetch your highlights with pagination and filters.

Query parameters:
- `page`: Page number (default: 1)
- `limit`: Results per page
- `source_id`: Filter by source
- `favorite`: Filter by favorites (true/false)
- `updated_since`: Only return highlights updated after this date

### Sources

**GET /api/v1/sources**

Fetch your sources (books, articles, etc.) with pagination.

## API Documentation

Full interactive API documentation is available at:

**[https://api.screvi.com/api/docs](https://api.screvi.com/api/docs)**

This Swagger UI lets you explore all endpoints, see request/response schemas, and try requests directly.

## Example Use Cases

- Export highlights to a custom Notion database
- Build an Obsidian plugin that syncs highlights
- Create a personal dashboard with reading statistics
- Automate highlight-to-Twitter/X posting workflows
- Feed highlights into an AI assistant's knowledge base


How to use Screvi's Public API to build custom integrations

Public API


## The Article Reader

Screvi's article reader provides a clean, distraction-free reading experience. Open any saved article from the **Articles** tab to start reading.

## Highlighting in Articles

1. Select any text passage while reading
2. The selection is automatically saved as a highlight
3. Highlights made in articles are added to your main highlight library
4. They appear in your feed, are searchable, and included in reviews

## Reader Features

### Typography Controls

Customize your reading experience:
- **Font family**: Choose between serif (Literata/Merriweather), sans-serif (Figtree), or system font
- **Font size**: Small, medium, large, or extra-large

### Table of Contents

For long articles, use the Table of Contents panel to jump between sections.

### Article Summary

Generate an AI-powered summary of any article. Useful for quick review or deciding whether to read the full piece.

### Highlights Panel

View all highlights you've made in the current article in one place.

### Notes

Add personal notes to the article for your thoughts and reflections.

## Managing Articles

### Inbox Workflow

Articles are organized with a status system:
- **Inbox**: Newly saved articles
- **Read Later**: Articles you've triaged and want to read
- **Archive**: Articles you've finished

### Tagging

Apply tags to articles for organization. Filter your article library by tag.

### Favorites

Mark articles as favorites for quick access.

## Special Content Types

### PDFs

Upload PDFs or save PDF URLs. The reader displays the PDF in a dedicated viewer. You can also extract existing PDF annotations as highlights using the [PDF Import](/docs/sync/pdf-highlights) feature.

### YouTube Transcripts

Saved YouTube videos display the full transcript. Timestamps are clickable. Tap to jump to that moment in the video.

### Instagram Posts

Saved Instagram posts are displayed with their content in the reader.


How to use Screvi's article reader to read distraction-free and highlight key passages

Reading and Highlighting Articles


## Overview

Screvi includes a full read-it-later system. Save articles from anywhere and read them in a clean, distraction-free reader with built-in highlighting.

## From the Browser Extension (Desktop)

1. Navigate to any web article
2. Click the **Screvi extension icon** in your browser toolbar
3. A toast notification confirms the save
4. After saving, you can assign tags directly from the notification

If the page has too little content (less than 50 words extracted), the extension offers a **"Save with HTML"** fallback that captures the full page content.

## From the Mobile App (Share Sheet)

### iOS

1. In Safari, Twitter, Reddit, or any app, tap the **Share** button
2. Select **Screvi** from the share sheet
3. The article is saved instantly
4. If you had text selected, it's also saved as a highlight linked to the article

### Android

1. Share any URL from any app
2. Select **Screvi** from the share options
3. The article is saved to your library

## From the Web App

1. Go to the **Articles** tab
2. Click **Add Article**
3. Paste any URL
4. The article is fetched and saved

## Saving YouTube Videos

1. With the browser extension installed, go to any YouTube video
2. Click the **"Open in Screvi"** button in the video's action bar
3. The video is saved with its full transcript
4. In the Screvi reader, highlight transcript passages with preserved timestamps

## Saving Newsletters

Each user gets a unique email address (format: `save+u_<token>@in.screvi.com`).

1. Find your Screvi email address in Settings or the Articles page
2. Subscribe to newsletters using this address
3. Newsletters are automatically saved as articles in your library

## What Gets Captured

When saving an article, Screvi extracts:
- Full article text (cleaned of ads and navigation)
- Title, author, and publication date
- Lead image
- Source URL

For PDFs, the file is stored and available for in-reader viewing. For YouTube videos, the full transcript is captured with timestamps.


How to save web articles, newsletters, PDFs, and YouTube videos to your read-it-later library

Saving Articles


## What It Does

Kindle and other e-reader exports often produce highlights with formatting issues:
- Extra spaces between words
- Broken line endings in the middle of sentences
- OCR artifacts from scanned books
- Minor typos or encoding issues

The AI Cleanup feature fixes these automatically.

## How to Use It

1. Open any highlight (from the feed, highlights page, or source view)
2. Click/tap the **AI Cleanup** option (or the cleanup icon)
3. Screvi's AI processes the text and generates a cleaned version
4. A **diff view** shows exactly what changed:
   - Word-by-word differences highlighted
   - Character-by-character changes visible
5. **Accept** to apply the changes, or **Reject** to keep the original

## What Gets Fixed

- Extra whitespace between words is normalized
- Line breaks in the middle of sentences are removed
- Obvious OCR artifacts are corrected
- Spacing around punctuation is fixed

## What Doesn't Change

The AI preserves the **meaning** of your highlight. It only fixes formatting. It doesn't rewrite, paraphrase, or alter the content.

## Original Content Preserved

Screvi stores the original text of your highlight even after cleanup. The original is used for deduplication, so reimporting the same highlight won't create a duplicate.


How to use AI to fix formatting issues in your highlights

AI Highlight Cleanup


## What is the Highlights Feed?

The feed is the main view of Screvi. It's a scrollable stream of your highlights designed to feel like a social media feed, but filled with your own ideas instead of other people's content.

By default, highlights appear in a **randomized order** so you naturally rediscover older highlights alongside recent ones. This is intentional. Serendipitous rediscovery is one of Screvi's core concepts.

## Browsing the Feed

The feed is available on:
- **Web app**: The home page at [app.screvi.com](https://app.screvi.com)
- **Mobile app**: The Home tab

Each highlight card shows the passage text, source title, author, and any tags. You can tap/click any highlight to see its full view and take actions.

## Filtering Your Feed

Use the filter panel to narrow down what you see:

- **Source type**: Books, articles, tweets, YouTube, documents
- **Tags**: Show only highlights with specific tags
- **Date range**: Filter by when highlights were created
- **Favorites only**: Show only highlights you've favorited
- **With notes only**: Show only highlights that have personal notes attached
- **Feed order**: Switch between random and chronological

On the web app, the filter panel is in the sidebar. On mobile, use the filter options at the top of the feed.

## Stories

At the top of the web app feed, there's a Stories row (similar to Instagram Stories) showing your recently updated sources. Tap a story to see all highlights from that source.

## Actions on Highlights

From any highlight in the feed, you can:

- **Add a note**: Attach personal reflections, connections, or action items
- **Edit**: Modify the highlight text
- **Favorite**: Mark important highlights for quick access later
- **Tag**: Add or remove tags
- **Share**: Generate a styled image card to share on social media
- **AI Cleanup**: Fix formatting issues (extra spaces, broken lines)
- **Find Related**: Discover semantically similar highlights from other sources
- **Suggest Tags**: Get AI-powered tag recommendations
- **Delete**: Remove the highlight from your library


How to use Screvi's main feed to browse, filter, and rediscover your reading highlights

Highlights Feed


## What is Semantic Search?

Unlike traditional keyword search, Screvi's semantic search understands the **meaning** behind your query. It uses AI embeddings (mathematical representations of text meaning) to find highlights that are conceptually related to what you're looking for, even if the exact words don't appear in your highlights.

## How to Use It

1. Go to the **Search** page (web app) or the **Search** tab (mobile app)
2. Type a natural-language question or topic
3. Results are ranked by semantic relevance
4. Click/tap any result to see the full highlight

## Example Queries

- "What did I read about making better decisions?"
- "Quotes about resilience and overcoming challenges"
- "Ideas about the compound effect of small habits"
- "Stoic philosophy on dealing with adversity"
- "Business strategy for startups"
- "Parenting advice about setting boundaries"

The AI finds highlights that match the **concept**, not just the words. A search for "building good habits" might return a highlight about "the power of tiny daily improvements", even though none of the search words appear in the highlight.

## Filtering Results

You can narrow search results with filters:

- **Source type**: Search only books, articles, tweets, etc.
- **Tags**: Limit to highlights with specific tags
- **Favorites**: Search only favorited highlights

## How It Works (Technical)

Screvi generates an AI embedding (a vector in high-dimensional space) for each of your highlights. When you search, your query is also converted to an embedding, and Screvi finds highlights whose embeddings are closest to your query's embedding using cosine similarity. This is powered by AI text-embedding models.

Embeddings are generated automatically for all your highlights. New highlights get their embeddings within a short time of being imported.


How to use Screvi's AI-powered search to find highlights by meaning, not just keywords

AI Semantic Search


## Sharing Highlights as Images

Generate styled quote cards from any highlight to share on social media, messaging apps, or save to your device.

### How to Share

1. Open any highlight
2. Click/tap the **Share** option
3. A styled image card is generated with:
   - The highlight text
   - Source title and author
   - Screvi branding
4. Save the image or share it directly

The generated image works great for Instagram, Twitter/X, WhatsApp, or any platform that supports images.

## Sharing Articles

Share any article from your Screvi library via a public link.

### How to Share an Article

1. Open any article in the article reader
2. Click/tap the **Share** option
3. Toggle sharing **on**. A unique public link is generated.
4. Copy and share the link

### What Happens When Someone Opens the Link

- They can read the full article in Screvi's clean reader (**no account required**)
- They can see highlights you've made in the article
- If they have a Screvi account, they can **save the article to their own library**

### Managing Shared Articles

- Toggle sharing **off** at any time to revoke access
- Each article has a unique share token. The link only works while sharing is enabled.

## Sharing Stats

From the Statistics page, you can also generate and share an image of your reading statistics (total highlights, sources, favorites, etc.).


How to share your highlights as images and articles as public links

Sharing Highlights and Articles


## Creating Tags

1. Go to the **Tags** page in the web app
2. Click "New Tag"
3. Enter a tag name
4. Choose a color. 18 preset colors are available, plus custom hex color support.
5. Save

Tags are shared across your highlights and articles.

## Applying Tags to Highlights

There are several ways to tag highlights:

- **From a highlight card**: Click/tap the tag option on any highlight and select tags
- **During import**: Some import methods allow you to assign tags as you import
- **AI suggestions**: Open a highlight, select "Suggest Tags", and Screvi's AI recommends relevant tags from your existing tags based on the highlight's content
- **Bulk tagging**: Select multiple highlights and apply tags in bulk

## Applying Tags to Articles

From any article detail view, use the tag option to add or remove tags.

## Filtering by Tag

Tags work as filters throughout Screvi:

- **Feed**: Filter to show only highlights with specific tags
- **Highlights page**: Use the tag filter dropdown
- **Articles page**: Filter articles by tag
- **Search**: Narrow search results to specific tags

## Managing Tags

From the Tags page, you can:

- **Edit** a tag's name or color
- **Delete** a tag (highlights and articles keep their other tags)
- **Search** through your tags
- **Sort** tags alphabetically or by count
- **View statistics**: each tag shows how many highlights and articles it's applied to

## Tips

- Use tags for broad themes (e.g., "Psychology", "Business", "Personal Growth") rather than per-book tags
- Let AI suggest tags to discover patterns in your reading
- Use tag filters in the feed to create focused reading sessions on a specific topic


How to create, manage, and use tags to organize your highlights and articles

Tags and Organization


## What is Topic Discovery?

Topic Discovery uses AI to analyze your entire highlight library and identify thematic clusters: groups of highlights that share common themes, even when they come from completely different books and sources.

## How to Use It

**In the web app:**
1. Go to the Feed page
2. Open the "Discover Topics" option

**In the mobile app:**
1. Go to the Search tab
2. Use the Topic Discovery feature

## What You'll See

Screvi identifies between 5 and 20 topics depending on the size and diversity of your library. Each topic shows:

- A descriptive label (generated by AI)
- The number of highlights in that topic cluster
- A preview of representative highlights

Tap/click a topic to see all highlights grouped under that theme.

## How It Works

1. Screvi uses the AI embeddings (vector representations) of all your highlights
2. These embeddings are clustered using semantic similarity algorithms
3. The resulting clusters are labeled by AI to give each topic a meaningful name
4. Topics are cached for performance and can be refreshed when your library grows

## Why It's Useful

- **Discover hidden connections**: Find that your highlights about psychology, philosophy, and business strategy all converge on the theme of "decision-making under uncertainty"
- **Explore your reading themes**: See what topics you gravitate toward most
- **Create focused review sessions**: Browse highlights by topic to deepen your understanding of a specific theme
- **Find gaps**: Notice which topics have few highlights and consider reading more in those areas


How Screvi's AI discovers thematic topics across your highlight library

Topic Discovery


## Step 1: Create Your Account

Go to [app.screvi.com](https://app.screvi.com) and sign up with your email or Google account. You'll get a **7-day free trial**, no credit card required.

## Step 2: Complete Onboarding

After signing up, Screvi walks you through a short onboarding:

1. **Choose your sources**: Select where your highlights come from (Kindle, Kobo, Apple Books, etc.)
2. **Pick topics**: Choose topics that interest you to get a curated starter set of highlights
3. **Set review preferences**: Choose when you'd like to receive daily review reminders

## Step 3: Import Your Highlights

Go to the **Integrations** page to import from your primary source:

- **Kindle users**: Install the [Chrome extension](https://chromewebstore.google.com/detail/screvi/jopgcmheadpaaimmmidpdoonhopfihkp), visit [read.amazon.com/notebook](https://read.amazon.com/notebook), and click "Import Highlights"
- **Kobo users**: Connect your Kobo via USB and upload the `KoboReader.sqlite` file from the `.kobo` folder
- **Apple Books users**: Download the Screvi Desktop App and paste your API key
- **PDF readers**: Upload your annotated PDFs directly
- **Readwise users**: Import via CSV or API sync

See the [Sync documentation](/docs) for detailed guides for each source.

## Step 4: Install the Browser Extension (Recommended)

The Chrome/Firefox extension lets you:

- **Auto-sync Kindle highlights** in the background
- **Save any web article** with one click
- **Highlight text on any website** via right-click
- **Import Twitter/X bookmarks**

Install from the [Chrome Web Store](https://chromewebstore.google.com/detail/screvi/jopgcmheadpaaimmmidpdoonhopfihkp). It connects automatically when you log in to the web app.

## Step 5: Download the Mobile App (Optional)

Get the iOS or Android app for:

- On-the-go access to all your highlights
- Physical book scanning (camera OCR)
- Share extension to save articles from any app
- iOS home screen widget with rotating quotes
- Offline reading

## Step 6: Start Reviewing

Once you have at least **3 sources and 20 highlights**, the review system activates:

- **In the app**: Go to the Review page and start a review session
- **Via email**: Configure your daily email digest in Preferences (choose time, frequency, and number of highlights)
- **On your phone**: Swipe through highlights in the mobile app's review screen
- **From your home screen**: Add the iOS widget for passive review throughout the day

## What's Next?

- [Use the highlights feed](/docs/features/highlights-feed) to browse and filter your library
- [Try semantic search](/docs/features/semantic-search) to find highlights by meaning
- [Set up tags](/docs/features/tags) to organize highlights by theme
- [Configure email digests](/docs/review/email-digest) for hands-free review
- [Save articles](/docs/articles/saving-articles) to build a read-it-later library with built-in highlighting


Get up and running with Screvi in 5 minutes, from sign-up to your first review

Quick Start Guide


## Overview

The Screvi Android app gives you full access to your highlight library, with share intent support for saving articles from any app.

Download from [Google Play](https://play.google.com/store/apps/details?id=com.screvi.app).

## Main Features

The Android app includes all the core features available on iOS:

- **Home Feed**: Browse your highlights with filtering and randomized order
- **Articles**: Read saved articles in a distraction-free reader with highlighting
- **Search**: AI semantic search across all highlights
- **Sources**: Browse all your books, articles, and other sources
- **Review**: Spaced repetition review with swipe-based interface
- **Settings**: Account, integrations, notifications, theme, and offline settings

## Adding Highlights

- **Text**: Type or paste manually
- **Voice**: Record audio for AI transcription
- **Camera**: Take a photo for AI text extraction
- **Gallery**: Select a photo for text extraction

## Sharing Articles to Screvi

On Android, Screvi registers as a share target:

1. In any app (Chrome, Twitter, Reddit, etc.), tap **Share**
2. Select **Screvi** from the share options
3. The URL is saved as an article in your library

## Kindle Import

Import your Kindle highlights directly from the Android app:

1. Go to **Settings > Integrations > Kindle**
2. Sign in to your Amazon account in the built-in browser
3. Your highlights are imported automatically

## Dark Mode

The Android app supports light, dark, and system theme modes. Configure in **Settings**.

## Offline Support

Articles you've read are cached locally. Highlights created without an internet connection are queued and synced when connectivity returns.


Guide to using the Screvi Android app: features, sharing, and Kindle import

Android App Guide


## Overview

The Screvi browser extension lets you save articles, highlight text, import Kindle highlights, and import Twitter/X bookmarks, all from your browser.

Available for:
- [Chrome](https://chromewebstore.google.com/detail/screvi/jopgcmheadpaaimmmidpdoonhopfihkp)
- Firefox (available on Firefox Add-ons)

## Connecting Your Account

1. Install the extension
2. Visit [app.screvi.com/login](https://app.screvi.com/login) and log in
3. The extension connects automatically. Your API key is sent to the extension securely.

Click the extension icon to verify you're connected (shows your email and subscription status).

## Saving Articles

Click the extension icon on any web page to save it as an article in Screvi.

- A toast notification confirms the save
- If the page has too little content, a "Save with HTML" fallback captures the full page
- After saving, you can assign tags directly from the notification

## Highlighting Text

1. Select text on any web page
2. Right-click and choose **"Save to Screvi"**
3. The text is visually highlighted on the page (yellow background)
4. The highlight is saved to your library, linked to the article

If the article doesn't exist yet, it's created automatically.

## Kindle Import

See the [Kindle Import guide](/docs/sync/kindle) for detailed instructions. In short:

1. Go to [read.amazon.com/notebook](https://read.amazon.com/notebook)
2. The Screvi import panel appears
3. Click "Import Highlights"
4. Enable background sync for automatic daily imports (every 24 hours)

Supports 7 Amazon regions (US, UK, Germany, France, Spain, Italy, Brazil).

## Twitter/X Bookmarks Import

See the [X Bookmarks guide](/docs/sync/x-bookmarks) for details. In short:

1. Go to [x.com/i/bookmarks](https://x.com/i/bookmarks)
2. The import overlay appears
3. Click "Start Import"

## YouTube Integration

An **"Open in Screvi"** button is added to YouTube video pages (next to Like/Share). Clicking it saves the video with its full transcript to your Screvi library.

## Troubleshooting

**Extension shows "Not connected"**:
- Visit [app.screvi.com/login](https://app.screvi.com/login) and log in
- Make sure the extension is enabled in browser settings

**Extension icon doesn't respond**:
- Try removing and reinstalling the extension
- Check that your subscription is active


Complete guide to the Screvi Chrome and Firefox browser extension

Browser Extension


## Overview

The Screvi iOS app gives you full access to your highlight library on the go, plus mobile-exclusive features like physical book scanning, the share extension, home screen widget, and offline reading.

Download from the [App Store](https://apps.apple.com/app/screvi/id6478136592).

## Main Features

### Home Feed

Browse your highlights in a scrollable feed with filtering by source type, tags, favorites, and date range. Same as the web app, but optimized for touch.

### Articles

Read saved articles in a clean reader. Highlight text while reading. Manage articles with inbox/read later/archive workflow. Explore curated and custom RSS feeds in the Explore tab.

### Search

Full semantic search across all your highlights. Type natural-language queries to find relevant content.

### Sources

Browse all your sources (books, articles, tweets, etc.) organized by type.

### Review

Swipe-based review interface. Swipe through highlights and use action buttons to rate, favorite, skip, or adjust frequency. Review streaks are tracked with a calendar visualization.

## Adding Highlights

The mobile app offers multiple ways to add highlights:

- **Text**: Type or paste a highlight manually
- **Voice**: Record audio. Screvi transcribes it using AI.
- **Camera**: Take a photo of a book page. AI extracts highlighted/underlined text.
- **Gallery**: Select a photo from your gallery for text extraction

## Share Extension

Save articles and highlights from any app using iOS's native share sheet:

1. In Safari, Twitter, Reddit, or any app, tap **Share**
2. Select **Screvi**
3. The article is saved automatically
4. If you had text selected, it's saved as a highlight linked to the article

The share extension uses a native Swift implementation for speed and reliability.

### Enabling the Share Extension

If Screvi doesn't appear in your share sheet:
1. Tap **More** at the end of the share sheet row
2. Find Screvi and toggle it on

## Home Screen Widget

Add a Screvi widget to your iPhone home screen for passive review throughout the day.

### Adding the Widget

1. Long-press on your home screen
2. Tap the **+** button
3. Search for **Screvi**
4. Choose **medium** or **large** size
5. Place it on your home screen

### What It Shows

- A rotating highlight quote, updated every 5 minutes
- A "Review ready" banner when you have a pending review session
- Tap the quote to open Screvi and see the full highlight

The widget works offline using cached quotes.

## Offline Mode

Read articles without an internet connection:

1. Go to **Settings > Offline**
2. Enable **auto-sync** to download articles automatically
3. Optionally enable **WiFi only** to save mobile data
4. Use **Sync Now** for manual downloads
5. Access offline articles from the **Offline** screen

Highlights created while offline are queued and synced automatically when you're back online.

## Push Notifications

Enable push notifications for:
- Daily review reminders
- Other important updates

Configure in **Settings > Notifications**.

## Quick Actions

Long-press the Screvi app icon for:
- **Add Highlight**: Jump straight to adding a new highlight
- **Support**: Get help


Complete guide to using the Screvi iOS app: features, share extension, widget, and offline mode

iOS App Guide


## What is the Email Digest?

Screvi can send you a curated selection of your highlights via email at a time you choose. Each email contains highlights selected by the spaced repetition algorithm, optimized for memory retention without you having to open the app.

## Setting Up Your Digest

1. Go to **Preferences** in the web app, or **Settings > Review Preferences** on mobile
2. Configure your options:

### Frequency

- **Daily**: Receive highlights every day
- **Every 3 days**: Highlights every 3 days
- **Weekly**: Once a week

### Time of Day

Choose when to receive your email. Many users set this for their morning routine or commute.

### Timezone

Set your timezone so the email arrives at the right local time.

### Highlights Per Email

Choose how many highlights to include in each email. The default works well for most users, but you can increase it if you want longer review sessions.

### Filters (Optional)

- **Favorites only**: Only include highlights you've favorited
- **Exclude source types**: Skip highlights from certain types (e.g., exclude tweets)
- **Tag filter**: Only include highlights with specific tags

## What's in the Email?

Each email contains:
- A curated set of highlights chosen by the spaced repetition algorithm
- Source information (book title, author) for each highlight
- Quick actions to interact with the highlights

## Pausing Emails

You can pause and resume your email digest at any time from the Preferences page without losing your review schedule.

## Tips

- Set the email for a time when you naturally check your inbox (morning coffee, commute, lunch break)
- Start with a small number of highlights per email and increase if you want more
- Combine email digests with in-app review for maximum retention


How to set up and configure Screvi's daily email digest with your highlights

Daily Email Digest


## What is Spaced Repetition?

Spaced repetition is a scientifically-backed learning technique where content is reviewed at increasing intervals. Items you remember well are shown less frequently, while items you struggle with appear more often. This optimizes your review time for maximum retention.

Screvi uses a **modified SM-2 algorithm**, the same method used by Anki flashcards.

## Prerequisites

To start reviewing, you need at least:
- **3 sources** (books, articles, etc.)
- **20 highlights**

## Reviewing in the Web App

1. Go to the **Review** page
2. Click **Start Review**
3. Each highlight is shown one at a time
4. For each highlight, choose an action:
   - **Show more often**: You want to see this highlight more frequently
   - **Show less often**: You know this well. Show it less.
   - **Don't show again**: Remove from the review queue entirely
   - **Favorite**: Mark as a favorite
5. The algorithm adjusts the next review date based on your response

## Reviewing in the Mobile App

1. Go to the **Review** screen (accessible from the tab bar, a push notification, or the widget)
2. Swipe through highlights in a Tinder-like interface
3. Use the action buttons at the bottom for more options

## How the Algorithm Works

Each highlight has an **ease factor**, a number that determines how often it appears:

1. When a highlight enters the review queue, it starts with a default ease factor
2. Each time you review it, the ease factor adjusts based on your response
3. "Show more often" decreases the interval; "Show less often" increases it
4. Over time, well-known highlights appear less, freeing up time for newer or harder-to-remember content

## Review Modes

- **Regular Review**: Standard spaced repetition across all your highlights
- **Topic Review**: Focus your review on a specific topic cluster

## Review Streaks

Screvi tracks your review consistency:
- **Current streak**: How many consecutive days you've reviewed
- **Longest streak**: Your all-time best
- **Calendar view**: Visual history of your review days

Complete a review session each day to maintain your streak.


How Screvi's spaced repetition system works and how to use it to remember what you read

Spaced Repetition Review


If you read physical books and highlight or underline passages, Screvi can extract that text using your phone's camera and AI.

This feature is available on the **iOS** and **Android** mobile apps.

## How It Works

1. Open the Screvi mobile app
2. Tap the **"+" button** to open the Add Idea screen
3. Tap the **camera icon** in the toolbar to take a photo, or the **gallery icon** to pick an existing photo
4. A drawing screen appears where you can mark the specific text you want extracted
5. Tap **"Extract Text"** to send the image to Screvi's AI for processing
6. The extracted text appears in the text field, ready to edit and save

## Drawing on the Image

After taking or selecting a photo, the drawing screen lets you highlight the passages you want extracted:

- **Draw over text** with your finger to mark the passages you care about. Screvi renders a yellow highlighter effect on the image.
- **Straight lines are auto-detected.** If you draw a roughly straight line, Screvi automatically snaps it to a perfectly straight underline.
- **Undo** removes the last stroke. **Clear** removes all drawings.
- If you don't draw anything, Screvi extracts all readable text from the entire image.

## Multiple Pages

You can scan multiple pages in a single session:

1. After taking or selecting your first photo, tap **"Add Page"** at the bottom
2. Take another photo or choose from your gallery
3. Navigate between pages using the arrows at the top
4. When you're done, tap **"Extract Text (X pages)"**

The AI processes all pages together and returns the combined extracted text.

## Assigning to a Source

After the text is extracted:

1. Review and edit the text if needed
2. Tap the **source selector** at the bottom to assign the highlight to a book
3. Search for an existing source, or create a new one by typing the book title
4. Optionally add tags, a page number, or a note
5. Tap **Save**

If you don't select a source, the highlight is saved under your **Personal Notes**.

## Tips for Best Results

- **Good lighting matters.** Make sure the page is well-lit and avoid shadows across the text.
- **Keep the page flat.** Try to avoid curved pages near the spine, as warping can make text harder to read.
- **Mark specific passages.** Drawing over the text you want gives the AI a clear signal of what to extract, rather than trying to grab everything on the page.
- **Use the gallery option** if you've already taken photos of book pages. You don't need to retake them.

## Voice Input

You can also add highlights by speaking:

1. On the Add Idea screen, tap the **microphone icon**
2. Speak your highlight, quote, or idea
3. Screvi transcribes the audio using AI
4. The transcription appears as editable text, ready to save

This is useful for capturing ideas or paraphrases while reading a physical book, without needing to photograph the page.

## Frequently Asked Questions

### What types of markings does the scanner detect?

The AI can read text that is highlighted with a physical highlighter, underlined, circled, or bracketed. You can also use the drawing tool on the photo to point out specific passages.

### Does it work with handwritten notes?

The AI primarily extracts printed text. Handwritten margin notes may or may not be recognized depending on legibility.

### How accurate is the text extraction?

The AI is very accurate for clearly printed text in good lighting. You can always review and edit the extracted text before saving.

### Can I scan multiple books in one session?

Each scan session saves highlights to a single source. To scan from a different book, save the current session first, then start a new one and assign it to the other book.


Use the Screvi mobile app to scan highlighted text from physical books using your phone's camera

How to Import Physical Book Highlights


Screvi lets you browse the most highlighted passages from popular books and add them to your library. This is useful for discovering key ideas from books you're reading, planning to read, or have already read but didn't highlight much.

## How It Works

1. Go to **Integrations > Popular Highlights** in the web app
2. Search for a book by title or author
3. Select the book from the results
4. Screvi shows the most popular highlights from that book, sorted by how many people highlighted each passage
5. Select the highlights you want (use "Select all" or pick individually)
6. Click **"Import selected"** to add them to your library

The highlights are imported as a new source in your library, or added to an existing source if the book is already there.

## Where to Find It

Popular highlights are accessible from two places:

### From the Integrations page

Go to **Integrations > Popular Highlights**. This is the main entry point where you can search for any book.

### From a source with no highlights

If you have a book source in your library that has zero highlights (for example, imported from Goodreads), Screvi shows a popular highlights picker directly on the source page. This makes it easy to populate the source with community highlights right away.

## What You See

For each highlight, you can see:

- The **highlight text** (the passage from the book)
- The **like count** (how many readers highlighted this passage)
- The **location** in the book (when available)

You can select individual highlights or use "Select all" to grab everything.

## Tips

- Popular highlights work best for well-known non-fiction and bestselling books. Niche or obscure titles may have few or no community highlights.
- Use popular highlights as a starting point, then add your own highlights as you read the book.
- Combine this with a Goodreads import: import your book library from Goodreads first, then add popular highlights to books you care about.
- You can always delete highlights you don't find useful after importing.


Browse and add popular community highlights from well-known books to your Screvi library

How to Import Popular Book Highlights


## Getting Started

### What is Screvi?

Screvi is a book highlights manager and digital commonplace book. It collects, organizes, and resurfaces your reading highlights from Kindle, Kobo, Apple Books, PDFs, web articles, Twitter/X, YouTube, and physical books. It helps you actually remember and use what you've read through spaced repetition review, AI-powered search, and a highlights feed.

### How much does Screvi cost?

Screvi offers a **7-day free trial** (no credit card required) followed by three plans:
- **Monthly**: $4.99/month
- **Yearly**: $49.99/year
- **Lifetime**: $199 one-time payment

All plans include every feature. Prices may vary by region.

### What happens to my data if I cancel?

Your data remains in your account. You can still log in and view your highlights, but active features like review, email digests, and AI features require an active subscription.

### Is there a limit on highlights?

No. There is no limit on the number of highlights, sources, or articles in your account.

## Sources and Importing

### Which platforms does Screvi support?

Screvi supports importing from:
- Amazon Kindle (7 regional stores via extension, mobile app, My Clippings file, or email)
- Kobo e-readers (via SQLite database file)
- Apple Books (via macOS desktop app or email)
- PDFs (direct annotation extraction)
- Goodreads (book library import + popular highlights)
- Readwise (CSV or API sync, for users switching from Readwise)
- Twitter/X (bookmarks via extension)
- Web articles (via extension or mobile share sheet)
- YouTube (video transcripts via extension)
- Markdown files
- Manual bulk input
- AI-powered intelligent parsing (any unstructured text)

### Can I use Screvi without a Kindle?

Yes. Screvi supports many sources beyond Kindle: Kobo, Apple Books, PDFs, physical books (via camera scanning), web articles, newsletters, Twitter, YouTube, manual input, and more.

### Can I import from multiple Kindle accounts?

Yes. Each import adds to your existing library. Screvi deduplicates highlights, so reimporting the same highlights won't create duplicates.

### Does Screvi work with Kindle Unlimited / borrowed books?

Yes. Any book you've highlighted in Kindle can be imported, regardless of how you acquired it.

### Can I switch from Readwise?

Yes. Screvi has a dedicated Readwise import that preserves all your highlights and tags. You can import via CSV export or direct API sync.

## Features

### Does Screvi support languages other than English?

Yes. Screvi supports highlights in any language. The AI features (search, cleanup, parsing) work best with English but support most widely-spoken languages. The Kindle import supports 7 Amazon regional stores (US, UK, Germany, France, Spain, Italy, Brazil).

### How does the spaced repetition algorithm work?

Screvi uses a modified SM-2 algorithm, the same scientific method used by Anki flashcards. Each highlight has an "ease factor" that determines review frequency. When you review a highlight and indicate how well you remembered it, the algorithm adjusts the next interval. Highlights you know well are shown less often; those you're less familiar with appear more frequently.

### What is semantic search?

Semantic search uses AI to understand the **meaning** of your query, not just keywords. You can ask questions like "what did I read about building good habits?" and get relevant results even if those exact words don't appear in your highlights.

### Is there an Android app?

Yes. Screvi is available on both iOS ([App Store](https://apps.apple.com/app/screvi/id6478136592)) and Android ([Google Play](https://play.google.com/store/apps/details?id=com.screvi.app)).

## Data and Privacy

### Is my data private?

Yes. Your highlights are private to your account. The only way others can see your content is if you explicitly share it (article sharing or highlight image sharing).

### How does the Kobo import handle my data?

The Kobo import parses the SQLite file entirely in your browser. The file is never uploaded to Screvi's servers. Only the extracted highlights are sent.

### Can I delete my data?

Yes. From Settings > Danger Zone, you can:
- **Reset Data**: Delete all highlights, sources, and articles while keeping your account
- **Delete Account**: Permanently delete your account and all data (also cancels your subscription)

### Can I export my data?

Yes. Go to Integrations > Export to download all your highlights as a ZIP file containing HTML (for Apple Notes) or Markdown files, organized by source. You can also use the Public API to access your data programmatically.

## Troubleshooting

### My Kindle highlights aren't importing

- Make sure you're logged in to Amazon at [read.amazon.com/notebook](https://read.amazon.com/notebook) in the same browser with the extension
- If you use a non-US Amazon store, make sure you're on the correct regional URL
- Let the import finish. It scrolls through your entire library and can take a few minutes.
- Try refreshing the page and clicking "Import Highlights" again

### The extension shows "Not connected"

Visit [app.screvi.com/login](https://app.screvi.com/login) and log in. The extension connects automatically. If it still doesn't work, try removing and reinstalling the extension.

### Email digests aren't arriving

- Check your spam/junk folder
- Make sure digests are enabled in Preferences with correct time and timezone
- You need at least 3 sources and 20 highlights for the review system to work

### How do I contact support?

Use the in-app feedback form, or email support@screvi.com. Pedro (the founder) personally responds to support requests.

### Can I request new features?

Yes! Visit the public feature request board at [screvi.featurebase.app](https://screvi.featurebase.app) to suggest features and vote on what gets built next.


Answers to common questions about Screvi: pricing, features, data, and more

Frequently Asked Questions


## What is Screvi?

Screvi is a **book highlights manager and digital commonplace book**. It collects, organizes, and resurfaces your reading highlights, bookmarks, and notes from multiple sources: Kindle, Kobo, Apple Books, PDFs, web articles, Twitter/X, YouTube, and even physical books.

The core problem: you read, you highlight, and then you forget. Highlights sit collecting digital dust across your Kindle, notebooks, and various apps. Screvi brings everything into one place and helps you actually revisit, remember, and use what you've read.

## Who is Screvi For?

- **Lifelong learners** who read non-fiction and want their reading to compound over time
- **Entrepreneurs and professionals** who need to retrieve ideas from books, articles, and podcasts for their work
- **Students and academics** reading across disciplines who need to connect ideas and review efficiently
- **Writers** who need to search their reading for supporting evidence and quotes
- **Casual readers** who just want their Kindle highlights somewhere they'll actually see them again

## How It Works

1. **Import your highlights** from any source: Kindle, Kobo, Apple Books, PDFs, web articles, Twitter, YouTube, or physical books
2. **Browse your feed**: a scrollable, social-media-style feed of your own highlights (instead of doom-scrolling)
3. **Review with spaced repetition**: Screvi brings back highlights at scientifically optimal intervals so you actually remember them
4. **Search with AI**: ask natural-language questions like "what did I read about building habits?" and get relevant results
5. **Discover connections**: AI-powered topic discovery finds themes across your reading you never noticed

## Available Platforms

| Platform | Where to Get It |
|---|---|
| **Web App** | [app.screvi.com](https://app.screvi.com) |
| **iOS App** | [App Store](https://apps.apple.com/app/screvi/id6478136592) |
| **Android App** | [Google Play](https://play.google.com/store/apps/details?id=com.screvi.app) |
| **Chrome Extension** | [Chrome Web Store](https://chromewebstore.google.com/detail/screvi/jopgcmheadpaaimmmidpdoonhopfihkp) |
| **Firefox Extension** | Firefox Add-ons |
| **macOS Desktop App** | Download from the integrations page |

All platforms sync through a shared backend. A highlight saved on one platform is immediately available everywhere.

## Getting Started

1. Create an account at [app.screvi.com](https://app.screvi.com) (7-day free trial, no credit card required)
2. Complete the onboarding to set up your preferences
3. Import your first highlights from your primary reading source
4. Install the browser extension and/or mobile app
5. Start reviewing once you have at least 3 sources and 20 highlights


Learn what Screvi is, who it's for, and how it helps you remember what you read

What is Screvi?


To import your Apple Books highlights, you have two options: use our desktop app (Mac only) or email your highlights directly from your iPhone or iPad.

## Desktop App Method

### Setup Steps

1. **Get Your API Key**
   - Go to [https://app.screvi.com/settings/api](https://app.screvi.com/settings/api)
   - Generate a new API key if you haven't already
   - Copy the API key (you'll need it later)

2. **Install Screvi Desktop**
   - [Download the Screvi desktop application](https://screvi.com/desktop-app)
   - Install the application on your Mac
   - Launch the application

3. **Use the App**
   - When prompted, paste your API key
   - Click on "Apple Books" in the sidebar
   - Click "Allow Access" when prompted to give Screvi access to your Apple Books library
   - Click on "Sync Now" to import your highlights

## Email Export Method

If you don't have a Mac or prefer not to install the desktop app, you can email your highlights directly from the Apple Books app on your iPhone or iPad.

### Setup Steps

1. **Open your book in Apple Books**
   - Launch the Apple Books app on your iPhone or iPad
   - Open the book containing the highlights you want to export

2. **Access your highlights**
   - Tap the actions menu in the bottom right corner
   - Select "Bookmarks & Highlights"
   - Switch to the "Highlights" tab

3. **Select and share your highlights**
   - Tap "Select" in the top left corner
   - Choose the highlights you'd like to send to Screvi
   - Tap the Share icon
   - Select your email app

4. **Send to Screvi**
   - Send the email to: **new@highlights.screvi.com**
   - Your highlights will be automatically imported into your Screvi account

## Frequently Asked Questions

### How often do highlights sync?
- **Desktop App**: The sync process needs to be initiated manually through the desktop app. There is no automatic sync like in the Chrome extension.
- **Email Export**: You need to manually email highlights each time you want to import them.

### Is it safe to give Screvi access to my Apple Books?
Yes, Screvi only requests read-only access to your highlights and book metadata. We cannot modify your library or access any other parts of your system.


Learn how to import and sync your Apple Books highlights with Screvi

How to Sync Your Apple Books Highlights


 Whether you're reading on mobile or desktop, Screvi makes it easy to capture insights from online articles.

## Available Methods

### 1. Mobile Apps

The simplest way to save article highlights on mobile devices is directly via your browser.

#### On iPhone/iPad (Safari):
1. Select the text you want to highlight on any article
2. Tap the **Share** icon from the bottom tabs (Important: Not the Share popup, otherwise it won't include the page URL)
3. Look for **Screvi** in the share options
4. Add any personal notes if desired
5. Tap **Save** to add the highlight to your library

#### On Chrome/Firefox
1. Select text on the article page
2. Tap **Share** from the context menu
3. Choose **Screvi** from the sharing options

**Note:** On Chrome, the article URL is not shared with screvi, so you'll have to manually add it to the highlight/source.


<img src="https://images.screvi.com/static/mobile-share.png" style={{ width: '100%', margin: '0 auto' }} alt="Mobile Browser Sharing" />

___

### 2. Chrome Extension

For desktop users, the Screvi Chrome extension provides the best experience for capturing article highlights.

#### Installation:
1. Visit the [Screvi Chrome Extension Page](https://chromewebstore.google.com/detail/screvi-kindle-and-x-bookm/ndlpohihdhnmgdnbmlgpnijmdddefooj) and install the extension.


#### Using the Extension:
1. **Select text** on any article or webpage
2. **Right-click** and choose "Save to Screvi" from the context menu
3. Done!

No extra UI elements or popups to slow down your browser, just a simple right-click menu item.

<img src="https://images.screvi.com/static/chrome-extension.png" style={{ width: '100%', margin: '0 auto' }} alt="Chrome Extension" />

___

### 3. Manual Entry

For times when you prefer full control over your highlight organization or when other methods aren't available, you can manually add article highlights directly through the Screvi web app.

#### Steps:
1. **Go to [app.screvi.com/sources](https://app.screvi.com/sources)**
2. **Add a new custom source** with the article information (title, author, image, URL, etc.)
3. **Manually add highlights** to the newly created source
4. Include your personal notes and insights as needed

This method gives you complete control over how your highlights are organized and tagged, making it perfect for academic research, storing PDF highlights, or when you want to be very deliberate about your highlight curation.

___

## Automatic Metadata Capture

When you save highlights from articles, Screvi will automatically try to capture the following metadata:
- **Article title**
- **Author name** (when available)
- **Publication date**
- **Source URL**

**Note:** Some websites might not provide all the metadata, but if some of the metadata is not available, you can always edit the highlight/source and add the missing information.


## Frequently Asked Questions

### Does the Chrome extension work on all websites?
The extension works on most websites, though some sites with strict content policies may limit text selection. It works perfectly on news sites, blogs, and educational content.

### Can I highlight from private or paywalled articles?
Yes, as long as you can select the text, you can save it to Screvi. The extension respects your existing access to content.

### What happens to highlights if an article gets deleted?
Your highlights are permanently saved in your Screvi library, so they remain accessible even if the source article is removed.


Learn how to capture highlights from web articles using Safari, mobile browsers, and the Chrome extension

How to Save Highlights from Articles



You can import your Kindle highlights to Screvi using different methods. Choose the option that best fits your reading setup:

## TLDR:

- **🖥️ [Chrome Extension](#chrome-extension)** - For books purchased on amazon.com
- **📱 [Mobile App](#mobile-app)** -  Same as the chrome extension, but on your mobile device
- **📧 [Kindle iOS App](#kindle-ios-app)** - For any type of book, but exports one book at a time. Includes sideloaded books or documents.
- **📁 [MyClippings.txt](#myclippingstxt-upload)** - For full control, includes all highlights in your kindle device. Requires connecting Kindle by USB

---

<h2 id="chrome-extension">Chrome Extension</h2>

**Best for:** Desktop users who want automatic daily syncing

Works with books purchased from Amazon's Kindle Store. Highlights automatically sync to Amazon's cloud at `read.amazon.com/notebook`.

### Setup Steps

1. **Install Extension**: Get the [Screvi Chrome Extension](https://chromewebstore.google.com/detail/screvi-kindle-and-x-highl/ndlpohihdhnmgdnbmlgpnijmdddefooj) from Chrome Web Store
2. **Click Extension Icon**: Find Screvi in your browser toolbar
3. **Login to Amazon**: You'll be redirected to Amazon's secure login (Screvi never stores your Amazon credentials and has no access to your account)
4. **Import Your Highlights**: Click "Import Your Highlights" and wait for the highlights to be imported.

---

<h2 id="mobile-app">Mobile App</h2>

**Best for:** Mobile-first users who primarily read on phones/tablets and don't want to use the Chrome Extension.

Use the Screvi mobile app to fetch highlights from your Kindle account. It works the same as the Chrome Extension, but on your mobile device.

### Setup Steps

1. **Download App**: Install from [App Store](https://apps.apple.com/us/app/screvi/id6670569420) or [Google Play](https://play.google.com/store/apps/details?id=com.screvi.app)
2. **Login to Screvi**: Sign in to your account
3. **Navigate to Kindle**: Go to Settings  > Kindle
4. Follow the instructions to connect your Kindle account




---

<h2 id="kindle-ios-app">Kindle App</h2>

**Best for:** Mobile users who want to export highlights from sideloaded books or documents

This method works for both Amazon books and personal documents within Kindle apps.

<img  style={{ width: '300px', margin: '0 auto' }} src="https://images.screvi.com/static/highlight-email.gif" alt="Kindle iOS App" />

### Setup Steps

1. **Open Kindle App**: Launch on your iOS, iPad, or Mac device
2. **Select Book**: Open the book with highlights you want to export
3. **Access Notebook**: Tap the "Notebook" icon (📓) in the top right
4. **Share Highlights**: Tap the "Share" or "Export" icon
5. **Choose Email**: Select the email option
6. **Send to Screvi**: Email to: `new@highlights.screvi.com`

**Important::** Make sure that the email you use to send the highlights is the same as the one you use to login to Screvi.


---

<h2 id="myclippingstxt-upload">MyClippings.txt Upload</h2>

**Best for:** Kindle e-reader users with personal documents, PDFs, or complete control needs

Every highlight you take on a Kindle device is saved to a local file called `MyClippings.txt` - this includes ALL your highlights regardless of book source.

### When to Use This Method
- Personal documents and PDFs sent to your Kindle
- Books from sources other than Amazon (sideloaded content)
- Books from other ebook stores
- You want complete control over your highlight data
- You want to import highlights that don't appear on read.amazon.com/notebook

### Setup Steps

1. **Connect Kindle to Computer**: Use the USB cable that came with your Kindle
2. **Open Kindle as Drive**: Your Kindle will appear as a removable drive
3. **Navigate to Documents**: Open the "documents" folder on your Kindle
4. **Find MyClippings.txt**: Look for this file (it contains all your highlights)
5. **Access Import Page**: Go to [app.screvi.com/integrations/kindle-import](https://app.screvi.com/integrations/kindle-import)
6. **Upload File**: Select "Upload MyClippings.txt" and choose your file
7. **Process Import**: Click "Upload" and wait for processing (usually under 1 minute)

### Benefits
- ✅ Imports highlights from ALL books (Amazon + personal documents)
- ✅ Most comprehensive method available
- ✅ Complete ownership of your highlight data
- ✅ Works with any book format supported by Kindle

> **Smart Duplicate Detection:** Screvi automatically detects and merges duplicate highlights, so you can safely re-upload your MyClippings.txt file without creating duplicates.


---

## Questions?

Still having trouble syncing your Kindle highlights? Don't hesitate to reach out.

**Send an email to:** [support@screvi.com](mailto:support@screvi.com)




Complete guide to importing your Kindle highlights into Screvi - choose your method based on your book source

Import from Amazon Kindle

Unfortunately, Kobo does not provide an API to retrieve highlights, so you'll have to connect your Kobo to your computer and share your highlights file with Screvi.

The advantage of this, is that you can sync highlights from any book, even if they were not purchased from the official Kobo store.


### Setup Steps

1. Go to the screvi Kobo import page: [https://app.screvi.com/integrations/kobo-import](https://app.screvi.com/integrations/kobo-import)
3. Follow the instructions to connect your Kobo to your computer
4. Select the books you want to sync
5. Click "Sync Now" to begin importing your highlights



## Frequently Asked Questions

### How often do highlights sync?
The sync process needs to be initiated manually whenever you want to import new highlights.

### What happens if I want to add new highlights? Will Screvi automatically detect them?
Yes, screvi will automatically detect new highlights and detect any duplicates.

### My book covers were not imported to Screvi
Screvi currently does not import book covers from Kobo, but you can fetch a book cover from the screvi web app, after you've imported your highlights.

Learn how to import and sync your Kobo highlights with Screvi

How to Sync Your Kobo Highlights


The manual bulk import feature is perfect for users who have highlights stored in unstructured formats like paper notebooks, Apple Notes, Obsidian, or any other text-based system. This tool helps you quickly add multiple highlights to a book without worrying about perfect formatting.

## When to Use Manual Import

This feature is ideal when you have:
- Handwritten notes from a paper notebook
- Highlights scattered across Apple Notes
- Notes stored in Obsidian or other note-taking apps
- Copy-pasted highlights from various digital sources
- Any collection of quotes or insights without consistent formatting

<img src="https://images.screvi.com/static/manual-input.png" style={{ width: '100%', margin: '0 auto' }} alt="Manual Import" />

### Setup Steps

1. Go to the Screvi manual import page: [https://app.screvi.com/integrations/manual-input](https://app.screvi.com/integrations/manual-input)
2. Fill in the book details:
   - **Title**: Enter the book, article, or source title
   - **Author**: Add the author name
   - **Source Type**: Select from Book, Article, Podcast, etc.
3. Paste your highlights in the text area
4. Follow the formatting guidelines below
5. Click "Parse Highlights" to import them to your library

## Formatting Your Highlights

### Basic Format
- **Separate each highlight with a double line break** (press Enter twice)
- Each highlight should be on its own paragraph
- No special formatting required

### Example:
```
This is my first highlight from the source.

This is my **bold** second highlight with *italic* text.
Note: This is my personal note about the highlight.

Another highlight here with some key insights.
```

### Advanced Formatting

**Personal Notes**: Add "Note:" at the beginning of a line to mark it as your personal note
```
This is a highlight from the book.
Note: This reminds me of my own experience with this topic.
```

**Markdown Support**: You can use markdown formatting:
- **Bold text** with `**bold**`
- *Italic text* with `*italic*`
- Lists and other markdown elements

### Tips for Best Results

2. **Don't worry about perfect formatting**: The tool is designed to handle messy input
3. **Use the preview**: Before submitting, use the preview section to see how your highlights will be rendered
4. **Add context**: Include personal notes to provide context for your future self

## Frequently Asked Questions

### Can I import highlights from multiple books at once?
No, the manual import tool processes one book/source at a time. You'll need to create separate imports for each book.

### What happens if I have duplicate highlights?
Screvi automatically detects and prevents duplicate highlights, so you can safely re-import without creating duplicates.

### Can I edit highlights after importing them?
Yes, once imported, you can edit, organize, and add tags to your highlights just like any other highlights in your Screvi library.


Learn how to import highlights from paper notebooks, Apple Notes, Obsidian, and other unstructured sources

How to Manually Import Highlights in Bulk


Screvi has a built-in PDF reader. Upload any PDF, read it in a clean viewer, and highlight text as you go. Highlights are saved to your library just like highlights from any other source.

## Uploading a PDF

There are three ways to add a PDF to Screvi:

### From the web app

1. Go to the **Articles** tab
2. Click **Add Article**
3. Drag and drop a PDF file onto the upload area, or click to browse for a file
4. The PDF is uploaded and saved as an article in your library

You can also paste a URL that points to a PDF file. Screvi detects the PDF and handles it automatically.

### From the browser extension

1. Navigate to any PDF in your browser
2. Click the **Screvi extension icon**
3. The PDF is saved to your library

### From the mobile share sheet

1. Open a PDF link in Safari or any app
2. Tap **Share** and select **Screvi**
3. The PDF is saved to your library

## Reading PDFs

Open a saved PDF from the **Articles** tab. The PDF renders in a full in-browser viewer with:

- **Page-by-page scrolling**: All pages are laid out vertically in a continuous scroll
- **Zoom controls**: Zoom in/out, or fit to width
- **Page thumbnails**: A sidebar (on desktop) shows page thumbnails for quick navigation
- **Page jumping**: Click the page number in the toolbar to jump to any page
- **Pinch-to-zoom**: On touch devices, pinch to zoom in and out

## Highlighting Text in PDFs

Select any text in the PDF to create a highlight. The highlight is saved to your main highlight library, linked to the PDF article.

- Highlights are anchored to specific pages, so they persist correctly even if you zoom or resize the window
- You can view all highlights for a PDF from the highlights panel in the reader sidebar
- Highlights appear visually on the PDF text, just like in the regular article reader

## Sharing PDFs

Toggle sharing on for any PDF article to generate a public link. Anyone with the link can:

- Read the PDF in Screvi's viewer (no account required)
- See highlights you've made
- Download the PDF

## PDF Annotation Import (Alternative)

If you have a PDF that already contains annotations (highlights, underlines, sticky notes) from another PDF reader, you can extract those annotations separately:

1. Go to **Integrations > PDF Import**
2. Upload the annotated PDF
3. Screvi extracts all annotations directly in your browser (the file is never uploaded to a server for this method)
4. Preview the extracted highlights grouped by type
5. Import them to your library

This is useful for importing existing annotations from tools like Adobe Acrobat, Preview, GoodNotes, or PDF Expert. The annotations are imported as highlights attached to a book source.

## Tips

- PDFs have a **50 MB** file size limit
- Screvi automatically extracts the title and author from PDF metadata when available. You can edit these after upload.
- Duplicate PDFs are detected automatically. If you try to upload the same PDF twice, Screvi redirects you to the existing article.
- The PDF reader uses its own formatting, so typography settings (font, size) from the regular article reader don't apply to PDFs.


Upload PDFs to Screvi and read them in the built-in reader with full highlighting support

How to Read and Highlight PDFs


There are two ways to get X (formerly Twitter) content into Screvi: bulk-import your bookmarks using the browser extension, or save individual posts by sharing a link.

## Method 1: Bulk Import via Browser Extension

The browser extension can import all your X bookmarks at once. Due to X's API limitations and costs, the extension reads bookmarks directly from your authenticated session, which is more stable and efficient than relying on the official X API.

### Setup Steps

1. Install the [Screvi Chrome Extension](https://chromewebstore.google.com/detail/screvi-kindle-and-x-highl/ndlpohihdhnmgdnbmlgpnijmdddefooj) from the Chrome Web Store
2. Go to [x.com/i/bookmarks](https://x.com/i/bookmarks) (you must be logged in to X)
3. The Screvi import overlay appears
4. Click **"Start Import"**
5. Wait for the sync to complete. Tweets are grouped by author and imported as highlights.
6. Optionally enable **Background Sync** to have your bookmarks sync automatically every 24 hours

## Method 2: Save Individual Posts by Link

You can save any individual X post or article to Screvi without the extension:

- **From the browser extension**: Click the Screvi extension icon while viewing any X post or article
- **From the mobile app (iOS/Android)**: Tap **Share** on any X post, then select **Screvi** from the share sheet
- **From the web app**: Go to **Articles > Add Article** and paste the X post URL

The post content is saved as an article in your Screvi library, where you can read it and highlight specific passages.

## Frequently Asked Questions

### Is it safe to use the Chrome extension?

Yes, it's completely safe. The Screvi extension only has access to your X bookmarks page. Screvi cannot access any other X account information, post on your behalf, or modify your account in any way.

### How often do bookmarks sync?

- Automatically syncs daily when background sync is enabled
- Manually sync anytime by clicking "Sync Now" in the extension

### Can I sync bookmarks from multiple X accounts?

Yes. You can switch between X accounts in your browser and sync bookmarks from each account separately.

### What's the difference between bulk import and saving individual posts?

Bulk import grabs all your bookmarked tweets at once and imports them as highlights grouped by author. Saving an individual post saves it as an article that you can read and highlight in the article reader. Use bulk import for your existing backlog, and share individual posts going forward as you find them.


Import your X (Twitter) bookmarks and save individual posts to Screvi

How to Sync Your X Bookmarks

<h2>Overview</h2>
<p>Screvi offers a public REST API for reading your highlights and sources programmatically. Use it to build custom workflows, export data to other tools, or create your own integrations.</p>
<h2>Authentication</h2>
<p>All API requests require an API key passed in the <code>X-API-Key</code> header.</p>
<h3>Getting Your API Key</h3>
<ol>
<li>Go to <strong>Settings > API</strong> in the Screvi web app</li>
<li>Copy your API key</li>
</ol>
<h3>Using the Key</h3>
<p>Include the key in every request:</p>
<pre><code>GET https://api.screvi.com/api/v1/highlights
X-API-Key: your-api-key-here
</code></pre>
<h2>Rate Limits</h2>
<ul>
<li><strong>100 requests per minute</strong> per API key</li>
<li>Rate limit headers are included in responses</li>
</ul>
<h2>Available Endpoints</h2>
<h3>Highlights</h3>
<p><strong>GET /api/v1/highlights</strong></p>
<p>Fetch your highlights with pagination and filters.</p>
<p>Query parameters:</p>
<ul>
<li><code>page</code>: Page number (default: 1)</li>
<li><code>limit</code>: Results per page</li>
<li><code>source_id</code>: Filter by source</li>
<li><code>favorite</code>: Filter by favorites (true/false)</li>
<li><code>updated_since</code>: Only return highlights updated after this date</li>
</ul>
<h3>Sources</h3>
<p><strong>GET /api/v1/sources</strong></p>
<p>Fetch your sources (books, articles, etc.) with pagination.</p>
<h2>API Documentation</h2>
<p>Full interactive API documentation is available at:</p>
<p><strong><a href="https://api.screvi.com/api/docs">https://api.screvi.com/api/docs</a></strong></p>
<p>This Swagger UI lets you explore all endpoints, see request/response schemas, and try requests directly.</p>
<h2>Example Use Cases</h2>
<ul>
<li>Export highlights to a custom Notion database</li>
<li>Build an Obsidian plugin that syncs highlights</li>
<li>Create a personal dashboard with reading statistics</li>
<li>Automate highlight-to-Twitter/X posting workflows</li>
<li>Feed highlights into an AI assistant's knowledge base</li>
</ul>
