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.
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/skewb1k/tsundoku.