Spotify Wrapped for your Kindle.
Turn My Clippings.txt into a beautiful, self-contained HTML report — reading timeline, top books, peak days, longest streak, best highlights. One command, 100% local, zero network calls.
$ reading-wrapped generate
Auto-detecting Kindle...
Found: /Volumes/Kindle/documents/My Clippings.txt
Parsed 1,847 clippings
Using year 2025 (most recent with data)
31 books · 1,204 highlights · 287 reading days
✓ Written to reading-wrapped-2025.html
✓ Opened reading-wrapped-2025.html in browser
- Hero card — your year number, big and golden
- Numbers row — books read, highlights made, words highlighted, reading days
- Top 5 books — ranked with a mini bar chart
- Monthly timeline — highlights-per-month bar chart, peak month highlighted
- Best day to read — weekday breakdown, your top reading day called out
- Longest streak — consecutive days with at least one highlight
- Top highlight — your single longest highlighted passage, displayed as a blockquote
All sections are rendered as a self-contained HTML file — no internet required, works offline in any modern browser.
- Spotify tells you what you listened to. Nobody does this for reading — even though your Kindle has been quietly recording every highlight, note, and bookmark for years.
My Clippings.txtis a goldmine sitting on your device. This tool finally surfaces it.
# Recommended: pipx keeps it isolated
pipx install reading-wrapped
# Or pip
pip install reading-wrapped
# From source
git clone https://github.com/nord342/reading-wrapped
cd reading-wrapped
pip install -e .# Auto-detect a connected Kindle and use the most recent year
reading-wrapped generate
# Specify a file explicitly
reading-wrapped generate ~/Desktop/"My Clippings.txt"
# Filter to a specific year
reading-wrapped generate --year 2024
# Custom output path and open immediately
reading-wrapped generate --out ~/Desktop/wrapped.html --open
# Full example
reading-wrapped generate ~/Documents/"My Clippings.txt" --year 2025 --out wrapped-2025.html --openIf you use kindle-archive to export your highlights as Markdown, you can feed the same My Clippings.txt into both tools:
# Archive highlights to Markdown, then generate wrapped report
kindle-archive sync ~/Documents/"My Clippings.txt" && \
reading-wrapped generate ~/Documents/"My Clippings.txt" --openThis tool is part of a set of local-first Kindle utilities:
| Tool | What it does |
|---|---|
| kindle-doctor | Diagnose and repair a corrupt or unresponsive Kindle |
| kindle-archive | Export highlights and notes to Markdown / JSON |
| rekindle | Surface random past highlights for spaced-repetition review |
| reading-wrapped | Visualise your reading year (this tool) |
MIT — see LICENSE.