SunnySunday.Cli is a command-line tool designed to deliver periodic highlights from your reading materials directly to your Kindle, offering a unique way to review your favorite passages without relying on mobile or web apps. The tool provides several standout features, including scheduled daily or weekly recaps of your highlights, the ability to exclude specific books, authors, or individual highlights, and a customizable weighting system that prioritizes more important notes. It also supports sending these recaps directly to your Kindle via email, ensuring you receive them without needing constant app access.
Ideal for Kindle users who want to review their reading materials periodically, SunnySunday.Cli provides a convenient way to organize and revisit highlights in a distraction-free environment. By automating the delivery of tailored content, it enhances your reading experience with focused and personalized recaps, allowing you to maintain a meaningful connection with your favorite texts over time. The tool can be easily installed using winget, making setup straightforward for users looking to integrate this efficient solution into their routine.
README
relego.
Revisit your highlights, delivered to your Kindle. For free.
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.
Capabilities:
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
Privacy: your reading habits are not sent to any cloud service
How it works
Connect your Kindle via USB and run relego import to import highlights from My Clippings.txt
The server selects a daily or weekly subset of highlights using spaced repetition (weighted by your preferences)
A recap document is sent to your Kindle email address via Amazon's Send-to-Kindle service
Open the recap on your Kindle like any other book
What a recap looks like
Each recap is an EPUB document delivered to your Kindle. Here's an example of what you'll see when you open it:
> #### 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."
> — by J.R.R. Tolkien
>
> -
> — by Walter Isaacson
>
> -
> — by Isaac Asimov
"The only way to do great work is to love what you do."
Steve Jobs
"Violence is the last refuge of the incompetent."
Foundation
Each highlight includes the quote, the book title, and the author, making it easy to recall context at a glance. The number of highlights per recap is configurable (default is 5).
Interactive mode
Run relego without arguments to open the interactive TUI:
Use the TUI to configure the server, browse highlights, and manage exclusions. For automation and scripting, use the CLI commands directly (see CLI reference).
Theme selection for TUI:
RELEGO_THEME=dark (default)
RELEGO_THEME=light
Getting started
1. Connect your Kindle device
Connect your Kindle device to your computer via USB cable.
> No Kindle handy? A sample My Clippings.txt is included at docs/examples/kindle-highlights.txt.
2. Run the server
Fill in KINDLE_EMAIL and the SMTP_* variables in docker-compose.yml, then:
docker compose --profile server up -d
> [!IMPORTANT]
> Amazon Send-to-Kindle only accepts emails from approved senders. Add the email address you are going to use in your Amazon "Approved Personal Document E-mail List" before testing delivery.
> [!TIP]
>
> Gmail and Outlook personal accounts do not support SMTP with password authentication anymore.
>
> Use a free SMTP relay like AWS SES, Resend, MailerSend or Mailgun instead. They offer free tiers with generous limits, suitable for Relego's everyday usage. Otherwise, you can use your own SMTP relay server.
>
> If you don't have or don't want to setup any SMTP server now, replace the SMTP settings in the relego-server block with the demo-mode block from docker-compose.yml, then run the demo profile: docker compose --profile demo up -d.
3. Import the Kindle highlights
It's time to import the highlights from your Kindle.
> Using the sample data in docs/examples? Append the local path to the import command shown in this section
Docker (no install)
Windows:
The simplest option is copying My Clippings.txt in the repo's root folder and mount that path:
The installer detects your Windows architecture automatically and prints the path where relego.exe was saved.
macOS / Linux
curl -fsSL https://raw.githubusercontent.com/Krusty93/relego/main/install.sh | sh
~/.local/bin/relego
The installer detects your OS and architecture automatically and prints the path where relego was saved. If ~/.local/bin is not already on your PATH, add export PATH="$HOME/.local/bin:$PATH" to your shell profile (~/.zshrc, ~/.bashrc, or ~/.profile), then open a new terminal.
Leave this blank if you only want Kindle delivery. Clear it at any time with relego config delivery-email "".
5. Explore the TUI
The TUI lets you sync highlights from My Clippings.txt, browse your library, manage exclusions, and adjust settings, all without leaving the terminal. To open it, launch the CLI without any argument:
If you've been using the demo mode, open http://localhost:5000 to view the captured email with the EPUB attachment, download it and forward it to your real Kindle email
Troubleshooting
Symptom
Fix
relego recap trigger returns an error
Verify the server is up with docker compose ps.
Trigger returns No eligible highlights available
No highlights imported yet. Run the import step first.
No email in smtp4dev
Check that the demo profile is running, and that the relego-server environment block is using ASPNETCORE_ENVIRONMENT=Development, SMTP_HOST=smtp4dev, and SMTP_PORT=2525.
smtp4dev web UI is blank
smtp4dev renders after a moment. Refresh the page.
CLI reference
Command
Description
relego
Open interactive TUI
relego import [path]
Import highlights from My Clippings.txt
relego status
Show server status and next recap
relego config show
Show all current server settings
relego config schedule [HH:MM]
Set recap schedule
relego config schedule show
Show current schedule
relego config count show
Show current highlights-per-recap setting
relego config count <1-15>
Set highlights per recap (default: 5)
relego config email kindle
Set the Send-to-Kindle email address
relego config email inbox
Set the inbox email address for HTML recap delivery. Pass "" to clear
relego exclude add
Exclude an entity from future recaps
relego exclude remove
Re-include an excluded entity
relego exclude list
List all exclusions
relego rename-book
Rename a book
relego weight set <id> <1-5>
Set highlight weight
relego weight list
Show weighted highlights
relego recap trigger
Trigger a recap immediately
relego --version
Print version
Known Limitations
The current version imports highlights from Kindle's My Clippings.txt only and delivers recaps to Kindle via Send-to-Kindle email.
Additional import sources and delivery targets are planned.
