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
- Import highlights from your Kindle (
My Clippings.txt) or Kobo (.kobo/KoboReader.sqlite)
- The server selects a daily or weekly subset of highlights using spaced repetition, weighted by your preferences
- A recap is sent through your configured delivery channel: Send-to-Kindle email for Kindle, or a regular inbox email for Kobo users
- 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:
> sh > 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"
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.