tsundoku
tsundoku (積ん読 — "pile of unread books") is a manga-discovery sidecar for Codex. It polls release sources like Nyaa, resolves each release to a canonical MangaBaka series, and surfaces what you don't own yet.
It deliberately does not track releases for series you already
have — Codex's release-nyaa plugin does that. tsundoku is the
"discover new things" half of the workflow.
The Feature showcase is the guided tour if you'd rather see than read.
How it fits together
┌────────────────────────────────────────────────────────────┐
│ Discovery sources (Nyaa, ...) │
│ │ │
│ ▼ │
│ Resolution pipeline │
│ 1. Known external ID (already in the catalog) │
│ 2. Foreign-ID lookup via MangaBaka │
│ 3. Fuzzy title search (cleaned query, Dice rescore) │
│ 4. Format-to-kind validation │
│ │ │
│ ▼ │
│ resolved / ambiguous / review_pending / unresolved │
└────────────────────────────────────────────────────────────┘
Confident matches land in your catalog. Ambiguous ones queue for human review with cleaned search queries, candidate covers, and a one-click provider-search modal.
Where to next
- New here? Start with Getting Started.
- Setting up a fresh deploy? Configuration is the field-by-field reference.
- Running it? Sources, Providers, the Browse feed, the Review queue, and Kept releases cover day-to-day operations.
- Going to prod? Deployment and Troubleshooting.
- Curious about the design? Architecture is the short tour.
The source lives at github.com/AshDevFr/tsundoku.