# suwayomi/suwayomi-server **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/suwayomi-suwayomi-server).** 6,499 stars · 332 forks · Java · mpl-2.0 ## Links - GitHub: https://github.com/Suwayomi/Suwayomi-Server - awesome-repositories: https://awesome-repositories.com/repository/suwayomi-suwayomi-server.md ## Topics `desktop` `hacktoberfest` `javalin` `kotlin` `manga` `manga-downloader` `manga-reader` `mangareader` `self-hosted` `tachidesk` `tachidesk-server` `tachiyomi` ## Description 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. ## Tags ### Networking & Communication - [OPDS Servers](https://awesome-repositories.com/f/networking-communication/opds-servers.md) — Serves manga library content via the OPDS protocol for use with compatible e-reader and reader applications. - [Structured Media Caches](https://awesome-repositories.com/f/networking-communication/remote-file-downloads/media-file-caching/structured-media-caches.md) — Stores downloaded chapter data in a structured file cache with metadata indexing for offline access and incremental updates. ### Part of an Awesome List - [Self-Hosted Servers](https://awesome-repositories.com/f/awesome-lists/media/anime-and-manga/self-hosted-servers.md) — Runs a personal manga server to organize, browse, and read manga from any device with offline support and automatic chapter updates. ### Content Management & Publishing - [Personal Library Managers](https://awesome-repositories.com/f/content-management-publishing/media-management/audiobook-servers/e-book-servers/comic-book-libraries/personal-library-managers.md) — Saves manga into a personal library with categories, and automates updates and downloads for new chapters. ([source](https://cdn.jsdelivr.net/gh/suwayomi/suwayomi-server@master/README.md)) - [Reading Progress Synchronization](https://awesome-repositories.com/f/content-management-publishing/reading-progress-synchronization.md) — Synchronizes reading positions across devices using timestamped progress markers for seamless continuity. - [Manga Chapter Downloaders](https://awesome-repositories.com/f/content-management-publishing/community-content-feeds/community-content-downloaders/restricted-content-downloaders/manga-chapter-downloaders.md) — Downloads chapters to local storage so manga can be read without an internet connection. ([source](https://cdn.jsdelivr.net/gh/suwayomi/suwayomi-server@master/README.md)) - [Cloudflare Challenge Solvers](https://awesome-repositories.com/f/content-management-publishing/content-aggregation-curation/content-aggregators/media-aggregators/manga-scrapers/cloudflare-challenge-solvers.md) — Uses FlareSolverr to automatically solve Cloudflare challenges when accessing protected manga source websites. - [Offline Media Management](https://awesome-repositories.com/f/content-management-publishing/digital-reading-materials/offline-media-management.md) — Downloads chapters for offline reading so content is available without an internet connection. ([source](https://cdn.jsdelivr.net/gh/suwayomi/suwayomi-server@master/README.md)) - [Manga Progress Syncs](https://awesome-repositories.com/f/content-management-publishing/reading-progress-synchronization/manga-progress-syncs.md) — Merges titles from the library into Neko and synchronizes reading progress in both directions. ([source](https://cdn.jsdelivr.net/gh/suwayomi/suwayomi-server@master/README.md)) ### Data & Databases - [Manga Library Backups](https://awesome-repositories.com/f/data-databases/backup-and-recovery/manga-library-backups.md) — Creates and restores library backups in a format compatible with Mihon for data portability and disaster recovery. - [Timestamped Progress Syncs](https://awesome-repositories.com/f/data-databases/data-synchronization-configurations/sync-endpoint-configurations/unidirectional-sync-configurations/bidirectional-sync-implementations/timestamped-progress-syncs.md) — Implements a bidirectional sync protocol using timestamped progress markers to reconcile reading positions across devices. - [Manga Progress Syncs](https://awesome-repositories.com/f/data-databases/cross-device-state-synchronization/media-progress-syncs/manga-progress-syncs.md) — Bridges reading progress between the server and Mihon (Tachiyomi) via a dedicated extension and tracker. ([source](https://cdn.jsdelivr.net/gh/suwayomi/suwayomi-server@master/README.md)) - [Structured Media Caches](https://awesome-repositories.com/f/data-databases/local-first-storage/local-caching-layers/structured-media-caches.md) — Stores downloaded chapter data in a structured file cache with metadata indexing for offline access and incremental updates. ### Development Tools & Productivity - [Android](https://awesome-repositories.com/f/development-tools-productivity/extension-runners/android.md) — Installs and runs third-party extensions built for Mihon to fetch manga chapters from various online sources. ([source](https://cdn.jsdelivr.net/gh/suwayomi/suwayomi-server@master/README.md)) ### Programming Languages & Runtimes - [Android Extension Runtimes](https://awesome-repositories.com/f/programming-languages-runtimes/runtime-execution-environments/javascript-runtimes/runtime-extensions/android-extension-runtimes.md) — Loads and executes third-party Android extensions in a server-side JVM environment to fetch manga content. ### Software Engineering & Architecture - [Plugin-Based Source Abstractions](https://awesome-repositories.com/f/software-engineering-architecture/software-architecture/architectural-patterns/plugin-module-systems/modular-plugin-architectures/plugin-based-architectures/plugin-based-architectures/plugin-based-source-abstractions.md) — Abstracts manga sources behind a plugin system that loads and executes third-party extensions at runtime. ### System Administration & Monitoring - [Server Management](https://awesome-repositories.com/f/system-administration-monitoring/administrative-operations/service-and-infrastructure-management/server-management.md) — Runs a personal manga server to organize, browse, and read manga from any device with offline support and automatic chapter updates. - [Remote Manga Servers](https://awesome-repositories.com/f/system-administration-monitoring/administrative-operations/linux-system-administration/networking/connection-lifecycle-management/remote-server-connectivities/remote-manga-servers.md) — Hosts the server on one machine and connects to it remotely from any client or web browser. ([source](https://cdn.jsdelivr.net/gh/suwayomi/suwayomi-server@master/README.md)) ### Business & Productivity Software - [Reading Trackers](https://awesome-repositories.com/f/business-productivity-software/reading-trackers.md) — Pushes reading progress updates to external tracking services like MyAnimeList and AniList for personal reading history. ([source](https://cdn.jsdelivr.net/gh/suwayomi/suwayomi-server@master/README.md)) ### DevOps & Infrastructure - [OAuth-Authenticated Webhook Dispatchers](https://awesome-repositories.com/f/devops-infrastructure/event-ingestion/webhook/oauth-authenticated-webhook-dispatchers.md) — Pushes reading progress updates to third-party tracking services via OAuth-authenticated webhook calls. - [Cloudflare Challenge Solvers](https://awesome-repositories.com/f/devops-infrastructure/proxy-integrations/cloudflare-challenge-solvers.md) — Routes requests through FlareSolverr to automatically solve Cloudflare challenges when accessing protected sources. ### Security & Cryptography - [OAuth Webhook Trackers](https://awesome-repositories.com/f/security-cryptography/oauth-authentication-apis/oauth-webhook-trackers.md) — Pushes reading progress updates to third-party tracking services via OAuth-authenticated webhook calls. - [Cloudflare Challenge Solvers](https://awesome-repositories.com/f/security-cryptography/traffic-protection/protection-bypassers/cloudflare-challenge-solvers.md) — Solves Cloudflare challenges automatically using FlareSolverr when accessing protected manga sources. ([source](https://cdn.jsdelivr.net/gh/suwayomi/suwayomi-server@master/README.md))