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

• Arch — packaging/tsunagu (latest tagged release) or packaging/tsunagu-git (latest commit). Either installs /usr/bin/tsunagu plus the sandbox jar it needs. Moku's default moku/moku-git PKGBUILDs depend on these to bundle the backend automatically.
• Nix — nix build .#tsunagu (see nix/packages.nix).

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.

Tsunagu's sandbox reimplements the Tachiyomi/Mihon extension API so third-party manga and anime extensions run unmodified in our own JVM process, and its backup format is interchangeable with Mihon's. Its overall shape — a headless JVM extension host exposed to a non-JVM backend — follows the approach pioneered by Suwayomi.

• Mihon (Tachiyomi's successor) — manga extension API and backup format. Apache License 2.0.
• Aniyomi — anime extension API. Apache License 2.0.
• Suwayomi — architectural reference for the sandbox/backend split; no code copied. Mozilla Public License 2.0.

See NOTICE.md for exactly which files are adapted from where, and THIRD_PARTY_LICENSES/ for full license texts.

Apache License 2.0 — see LICENSE.