Suwayomi/Suwayomi-Server
Suwayomi Server
Suwayomi-Server is a self-hosted manga server that serves content via OPDS feeds for use with compatible reader applications. It functions as a personal manga library server, allowing users to organize, browse, and read manga from any device with offline support and automatic chapter updates.
The server distinguishes itself through its extension-based source abstraction, which loads and executes third-party extensions at runtime to fetch content from various providers. It implements a bidirectional sync protocol using timestamped progress markers to reconcile reading positions across multiple client devices, and exports library metadata and reading progress into a portable JSON schema compatible with the Mihon ecosystem for disaster recovery and migration. The server also integrates with FlareSolverr to solve Cloudflare challenges automatically when accessing protected sources, and pushes reading progress updates to external tracking services via OAuth-authenticated webhook calls.
The project supports container deployment via Docker for isolated and portable hosting, and can be hosted remotely for access from any client or web browser. It provides library organization with categories, automated updates and downloads for new chapters, and offline reading capabilities through structured file caching.
Features
- OPDS Servers - Serves manga library content via the OPDS protocol for use with compatible e-reader and reader applications.
- Self-Hosted Servers - Runs a personal manga server to organize, browse, and read manga from any device with offline support and automatic chapter updates.
- Personal Library Managers - Saves manga into a personal library with categories, and automates updates and downloads for new chapters.
- Reading Progress Synchronization - Synchronizes reading positions across devices using timestamped progress markers for seamless continuity.
- Manga Library Backups - Creates and restores library backups in a format compatible with Mihon for data portability and disaster recovery.
- Timestamped Progress Syncs - Implements a bidirectional sync protocol using timestamped progress markers to reconcile reading positions across devices.
- Android - Installs and runs third-party extensions built for Mihon to fetch manga chapters from various online sources.
- Android Extension Runtimes - Loads and executes third-party Android extensions in a server-side JVM environment to fetch manga content.
- Plugin-Based Source Abstractions - Abstracts manga sources behind a plugin system that loads and executes third-party extensions at runtime.
- Server Management - Runs a personal manga server to organize, browse, and read manga from any device with offline support and automatic chapter updates.
- Reading Trackers - Pushes reading progress updates to external tracking services like MyAnimeList and AniList for personal reading history.
- Manga Chapter Downloaders - Downloads chapters to local storage so manga can be read without an internet connection.
- Cloudflare Challenge Solvers - Uses FlareSolverr to automatically solve Cloudflare challenges when accessing protected manga source websites.
- Offline Media Management - Downloads chapters for offline reading so content is available without an internet connection.
- Manga Progress Syncs - Merges titles from the library into Neko and synchronizes reading progress in both directions.
- Manga Progress Syncs - Bridges reading progress between the server and Mihon (Tachiyomi) via a dedicated extension and tracker.
- Structured Media Caches - Stores downloaded chapter data in a structured file cache with metadata indexing for offline access and incremental updates.
- OAuth-Authenticated Webhook Dispatchers - Pushes reading progress updates to third-party tracking services via OAuth-authenticated webhook calls.
- Cloudflare Challenge Solvers - Routes requests through FlareSolverr to automatically solve Cloudflare challenges when accessing protected sources.
- Structured Media Caches - Stores downloaded chapter data in a structured file cache with metadata indexing for offline access and incremental updates.
- OAuth Webhook Trackers - Pushes reading progress updates to third-party tracking services via OAuth-authenticated webhook calls.
- Cloudflare Challenge Solvers - Solves Cloudflare challenges automatically using FlareSolverr when accessing protected manga sources.
- Remote Manga Servers - Hosts the server on one machine and connects to it remotely from any client or web browser.
