📚 Toku

A private, offline-first personal book manager.

Track what you read. Own your data. No accounts. No social features. No cloud dependency.

Toku combines the metadata depth of Calibre, the reading tracking of Goodreads, and the analytics of StoryGraph — in a single CLI tool that keeps everything on your machine.

toku add --isbn 9780441013593          # Add a book by ISBN
toku add --title "Dune" -T sci-fi      # Add with tags
toku import goodreads ~/export.csv     # Import your Goodreads library
toku reading start "Dune" --page 1     # Start tracking progress
toku reading update "Dune" --page 145  # Log where you are
toku reading finish "Dune" --rating 5  # Done — rate it
toku stats --year 2025                 # See your reading stats
toku browse                            # Interactive TUI browser

Status: Active development (v0.4.0) — full-featured CLI, web dashboard, OPDS catalog server, optional end-to-end-encrypted multi-device sync, ebook file management, and native macOS/iOS/Windows apps. Phases 0–7 complete. See the platform support matrix for what's production-ready vs. in beta vs. planned.

---

Why "Toku"?

Toku (読く) comes from the Japanese kanji 読 — meaning to read.

The name is also a nod to 積ん読 (tsundoku) — a Japanese word with no English equivalent that describes the act of acquiring books and letting them pile up unread. It's not a criticism; it's a shared, self-aware feeling every reader knows. You buy faster than you read. The stack grows. You love every unread spine on the shelf anyway.

Toku is the tool for the reader who wants to see the full picture: what they've read, what they're reading, and — yes — everything they've been meaning to get to. It tracks your progress without judgment, keeps your data private, and never asks you to share, follow, or perform your reading for an audience.

The name captures both the act of reading and the honest relationship readers have with their ever-growing libraries.

---

Principles

• Your data, your machine. Everything lives in a local SQLite database. No accounts, no servers, no cloud required. Back it up however you like.
• No social features. No friends, followers, feeds, or book clubs. Reading is private. Your library is for you.
• Import everything. Bring your Goodreads, Calibre, or StoryGraph history. Years of reading data should transfer in seconds.
• CLI-first. A fast, scriptable command-line tool. The web dashboard, iOS, macOS, and Windows apps are built on the same core library — the CLI stays the primary, canonical interface.
• Open source. MIT licensed. Contributions welcome.

Features

• 📖 Add books manually, by ISBN, or by Open Library search
• 📊 Reading progress tracking (pages, percentage, chapters, audiobook time)
• 🏷️ Tags for organizing your library (imported Goodreads shelves become tags)
• 📈 Reading statistics and analytics (pace, format breakdown, yearly filtering)
• 📥 Import from Goodreads CSV, Calibre, and StoryGraph (with dry-run, dedup, and tag preservation)
• 📤 Export to CSV, JSON, Markdown, and canonical backup (ZIP)
• 🔍 Full-text search across your entire library (titles, authors, descriptions)
• 🖥️ Interactive TUI browser with split-pane layout, filters, and live detail view
• 🔄 Bulk operations for tagging, status changes, and deletions across filtered sets
• 📚 Ebook file management — associate .epub/.pdf/.mobi/.azw3 files with books (toku file add), verify integrity by SHA-256 (toku file verify), report disk usage (toku file usage), organize files into a managed library by a path template (toku file organize), and convert formats via Calibre's ebook-convert (toku convert)
• 🌐 Web dashboard (toku serve) with statistics, import wizard, library views, and dark mode — loopback-only by default, or run authenticated for network access (hosted mode & auth)
• 📚 OPDS catalog server (toku opds serve) so e-readers (KOReader, Moon+ Reader, etc.) can browse and download your associated ebook files over the local network — optional HTTP Basic auth
• 🍎 macOS app (SwiftUI) with sidebar navigation, sortable table/grid views, and Swift Charts
• 📱 iOS app (iPhone + iPad) with cover grid, barcode scanner, and reading progress updates
• 🪟 Windows desktop app (Tauri v2) wrapping the web UI in a native window with system tray
• 🔄 Optional multi-device sync via a self-hostable relay server (deployment guide) with end-to-end encryption
• 🔑 Account Secret Key + printable Emergency Kit for zero-knowledge sync (recovery guide)

Platform support

Toku ships several interfaces built on the same Rust core library. Not all are at the same maturity level:

Platform	Status	Notes
CLI (toku)	✅ Production	The primary, canonical interface. Every feature lands here first.
Web dashboard (toku serve)	✅ Production	Statistics, import wizard, library views, dark mode. Loopback-only by default; hosted mode & auth for network access.
OPDS catalog (toku opds serve)	✅ Production	Serves associated ebook files to e-reader apps over the local network.
Sync relay (toku-sync)	✅ Production	Optional, self-hostable, end-to-end encrypted. See the self-hosting guide.
macOS app (SwiftUI)	🟡 Beta	Native sidebar, sortable table/grid views, Swift Charts.
iOS app (iPhone + iPad)	🟡 Beta	Cover grid, barcode scanner, reading progress updates.
Windows desktop (Tauri v2)	🟡 Beta	Wraps the web UI in a native window with system tray.
watchOS app	⏳ Planned	Not yet shipped — tracked in #178.

Documentation

• Self-hosting the sync server — overview and quick start
• Sync server deployment guide — full Docker/reverse-proxy reference
• Web dashboard hosted mode & authentication
• Account recovery: Secret Key & Emergency Kit
• Self-hosting threat model — security & privacy analysis

Tech Stack

• Language: Rust
• Database: SQLite with FTS5
• CLI: clap v4
• Web: Axum + maud (server-side rendered HTML with inline SVG charts)
• Sync: self-hostable relay server with end-to-end encryption (zero-knowledge)
• Desktop: Tauri v2 (Windows)
• Mobile/macOS: SwiftUI via Rust FFI (toku-ffi crate)
• Architecture: Cargo workspace with 12 crates — core, database, metadata, import, export, files, CLI, FFI, web, desktop, and the sync server and client

License

MIT

Acknowledgments

• Book metadata and cover images from Open Library by the Internet Archive.

---

Built by kafkade.