Features
Everything Unearthed Local can do for your reading workflow.
Kindle Highlight Sync
Log into your Amazon account through a built-in browser, and Unearthed automatically imports all your books and highlights. Everything is stored locally on your computer.
KOReader Integration
Unearthed runs a local HTTP API server on a specific port that KOReader can send highlights to.
Setup Steps:
- Open Settings → API Endpoint section
- Note your device's local IP (displayed automatically)
- Copy the API URL
- Configure the Unearthed KOReader Plugin with this URL and your secret token
- Highlights are received and stored automatically
Note: Both KOReader and Unearthed need to have the same secret token set for the connection to work.
Export to Obsidian
Export all highlights as formatted Markdown files directly into your Obsidian vault.
YourVault/
└── Unearthed (your choice)/
├── Books/
│ ├── Book Title.md
│ └── Another Book.md
└── Articles/
└── Article Title.mdCSV Export
Export your entire library as CSV files for spreadsheets or other tools. One file per book with columns: Quote, Note, Location, Color, CreatedAt. Auto-incrementing folder names to avoid overwrites.
RSS Feed Reader
Subscribe to RSS feeds, browse articles from all your subscriptions, and import them into your local library for highlighting and note-taking. The article list fills the full screen height for comfortable scrolling, and controls are collapsible to maximise reading space.
Article Highlighting & Notes
Imported RSS articles can be opened in an advanced editor with color-coded highlighting and note-taking, just like Kindle highlights.
Capabilities:
- Select text and highlight with four colors: yellow, blue, pink, orange
- Add text notes to any highlight
- Edit or delete existing highlights
- Copy selected text to clipboard via the selection toolbar
- Delete articles with X — styled confirmation dialog with Enter/Escape support (disabled during search/editing)
- Search within article text
- Highlights are stored in the database and exported to Obsidian like book quotes
Home tab: The latest 10 RSS articles are displayed on the Home tab with quick-access actions (view, import, open, hide).
YouTube Embed Support
RSS articles containing YouTube links are automatically detected and displayed with an embedded video player. Video transcripts are fetched and injected into the article content when available.
Rate limiting: Transcript fetching retries automatically on rate limits (up to 3 attempts with exponential backoff).
Daily Reflection
Get a random quote from your library displayed on the dashboard each time you open the app. Optionally append it to your Obsidian daily note.
Configurable options:
- Date format: full moment.js-compatible tokens (e.g.
YYYY-MM-DD,YYYY/MM-MMMM/YYYY-MM-DD-dddd) - Slashes in the format create subfolders automatically
- Daily notes folder path
- Append Under Heading: insert reflections under a specific markdown heading (e.g.
### Daily Reflection) instead of at the end of the file - Create Obsidian Daily Note if it doesn't exist
- Add Daily Reflection on Startup
- Template with variables:
{{content}},{{bookTitle}},{{author}},{{fileName}}
How these settings work together:
If "Create Daily Note" is disabled but "Add Reflection on Startup" is enabled, Unearthed will wait until you manually create your daily note in Obsidian, then it will automatically add the reflection to it.
Global Search
Search across all books, quotes, and notes using Ctrl+K / Cmd+K.
- Full-text search across titles, authors, content, and notes
- Results grouped by source with match type indicators (title, quote, note)
- Keyboard navigation with arrow keys and Enter
- Click a result to open the book and scroll to the specific quote
Library Management
View, search, filter, and manage all your sources from the dashboard.
- Search books by title or author
- Filter: All, Active, or Ignored sources
- Toggle ignored status (excluded from Obsidian export)
- Delete individual sources or their quotes
- Batch select and operate on multiple sources
- View all quotes for any source in a detailed modal with color-coded accent bars
Dark / Light Mode
Toggle between dark and light themes from the header. Preference is persisted across sessions in settings.
System Tray & Startup
When Keep App Running is enabled, closing the window minimizes to the system tray instead of quitting. The app continues running for auto-sync and API server availability.
Status bar: A compact single-line status bar shows sync activity at a glance, with an expandable log panel for detailed output.
Keyboard Shortcuts
Unearthed Local is designed for keyboard-first navigation with 55+ shortcuts across every part of the app. All shortcuts are completely customisable — remap any shortcut to your preferred key combination in Settings → Keyboard Shortcuts. Custom bindings are saved automatically and take effect immediately without restarting.
Press Ctrl/Cmd + / at any time to view the shortcuts help overlay inside the app.
Customising Shortcuts
Open Settings → Keyboard Shortcuts to remap any shortcut. Click on a shortcut, press your desired key combination, and save. Your custom bindings are persisted across sessions and apply instantly — no restart required.
Custom Highlight Colors
Override the default color hex values in Settings → Quote Colors. Three color modes available: none, background (gradient), text.
Yellow
#ffd700
Blue
#4682b4
Pink
#ff69b4
Orange
#ffa500
Red
#ff4d4f
Green
#52c41a
Olive
#b5b35c
Cyan
#13c2c2
Purple
#a259d9
Gray
#888888
Custom Templates
Customize how your exports look with template variables in Settings → Template Settings.