Learn from your highlights. For free.

Why relego · See it · How it works · Getting started · Documentation

Why relego.

Relego comes from the Latin relegere: to read again, go over carefully, review. That is the core idea of the project: bring your highlights back to Kindle so they can be revisited, not forgotten.

• E-ink first: recaps delivered as native Kindle documents, not push notifications on your phone
• Free and self-hosted: no subscription, no data leaving your infrastructure
• No lock-in: your highlights stay yours, in an open format
• Multiple import sources: Kindle and Kobo supported today
• Privacy: your reading habits are not sent to any cloud service

See it

---

How it works

1. Import highlights from your Kindle (My Clippings.txt) or Kobo (.kobo/KoboReader.sqlite)
2. The server selects a daily or weekly subset of highlights using spaced repetition, weighted by your preferences
3. A recap is sent through your configured delivery channel: Send-to-Kindle email for Kindle, or a regular inbox email for Kobo users
4. Open the recap on your Kindle or in your inbox and revisit what mattered

Each recap is an EPUB document. Here's a sample of what it contains:

Relego Daily Recap (2026-05-21 18:00)

• "Care About Your Craft" — The Pragmatic Programmer by David Thomas & Andrew Hunt

• "Clean code is simple and direct." — Clean Code by Robert C. Martin

• "In a hole in the ground there lived a hobbit." — The Hobbit by J.R.R. Tolkien

---

Getting started

1. Run the server and web UI

docker compose --profile app up -d

Then open http://localhost:8081 in your browser.

Tip

To try Relego without configuring a real mail server, use the demo profile instead:

docker compose --profile demo up -d

The demo profile runs a local fake SMTP server (smtp4dev) at http://localhost:5000.

2. Import your highlights

Drag and drop your My Clippings.txt or KoboReader.sqlite file onto the Import page in the web UI, or use the CLI:

docker compose run --rm relego-cli import "/path/to/My Clippings.txt"

Tip

The browser extension syncs your Kindle Notebook in the background, replacing the manual file import.

3. Set up delivery

In the web UI, go to Settings and fill in your Kindle email and SMTP server details.

Important

Amazon Send-to-Kindle only accepts emails from approved senders. Add the sender address to your Amazon "Approved Personal Document E-mail List" before testing delivery.

For full configuration details, SMTP provider options, and troubleshooting, see the documentation.

---

CLI

The relego CLI can be used instead of the web interface. See the CLI documentation for installation instructions and full command reference.

---

For contributors

Relego is open source and built to be extended. See CONTRIBUTING.md and the Architecture documentation.

---

Supply chain verification

Verify Docker image origin via GitHub CLI:

gh attestation verify \
  oci://ghcr.io/krusty93/relego.server:latest \
  --owner Krusty93

gh attestation verify \
  oci://ghcr.io/krusty93/relego.cli:latest \
  --owner Krusty93

---

License

MIT, see LICENSE.