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:

  1. Open Settings → API Endpoint section
  2. Note your device's local IP (displayed automatically)
  3. Copy the API URL
  4. Configure the Unearthed KOReader Plugin with this URL and your secret token
  5. 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.md

CSV 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.

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.

  • Show App — Bring window to foreground
  • Quit — Fully exit the application

Keyboard Shortcuts

v1.3.5

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.