Tsunagu

Self-hosted backend for manga, light novels, and anime.

nix develop
cd backend && go run ./cmd/server

GraphQL at http://localhost:6007/api/graphql (playground at /api/graphql/playground).

• backend/ — Go API server, DB, download queue, media pipelines
• sandbox/ — JVM extension loader/executor
• proto/ — shared gRPC contract

Two independent, optional gates in front of the API:

• Static API token — set api_token in tsunagu.toml; clients send Authorization: Bearer <token> or ?token=.
• Password + sessions — set a password (setPassword mutation, or from a connected client's settings). Login via POST /api/auth/login returns a 30-day HMAC-signed session token; GET /api/auth/status reports whether a password is required. Either credential is accepted independently.

Neither is required for local/loopback use — auth only matters once the server is reachable from outside your machine.

• Mihon/Tachiyomi-format export (.tachibk) — exportMihonBackup/importMihonBackup mutations. Manga/novel library only; anime is never included, since the format has no concept of it.
• SQLite snapshots — createDatabaseBackup/deleteDatabaseBackup mutations, plus automatic scheduled snapshots via backup_interval_hours/backup_retention_count in tsunagu.toml.