How jeffuntalan/suwayomi-rakuyomi-source works
This is an Aidoku source plugin that lets Rakuyomi/KOReader browse and read a library served by Suwayomi. The main flow is a client request through the source’s handlers, GraphQL queries for manga and chapters, conversion into Aidoku models, then chapter-page URLs returned for reading. The README also documents library search, filters, sorting, categories, recent updates, configurable server settings, and optional Basic Auth. Source excerpts show the principal calls; some endpoint relationships are documented only in the README.
Main entry points: lib.rs Source Handlers · graphql.rs GraphQL Client · helpers.rs Aidoku Conversion · rest.rs REST URL Helpers
Components 15
Aidoku Source
- Source Handlers
src/lib.rs - Server Settings
res/settings.json - Library Search
src/lib.rs - Category Listings
src/lib.rs - Manga Details
src/lib.rs - Chapter Lists
src/lib.rs - Home & Recent
src/lib.rs - Chapter Pages
src/lib.rs - Image Requests
src/lib.rs
Suwayomi API
- GraphQL Client
src/api/graphql.rs - Response Models
src/api/models.rs - REST URL Helpers
src/api/rest.rs
Model Mapping
- Aidoku Conversion
src/helpers.rs
Other components
- Rakuyomi / KOReader
- Suwayomi Server
Connections 18
- Rakuyomi / KOReader → Source Handlers: requests source data
README.md - Source Handlers → Server Settings: reads settings
- Source Handlers → GraphQL Client: invokes queries
src/lib.rs - Source Handlers → Aidoku Conversion: converts responses
src/lib.rs - Library Search → Source Handlers: handled by
src/lib.rs - Category Listings → Source Handlers: handled by
src/lib.rs - Manga Details → Source Handlers: handled by
src/lib.rs - Chapter Lists → Source Handlers: handled by
src/lib.rs - Home & Recent → Source Handlers: handled by
src/lib.rs - Chapter Pages → Source Handlers: handled by
src/lib.rs - Image Requests → Source Handlers: handled by
src/lib.rs - GraphQL Client → Response Models: deserializes into
src/api/graphql.rs - Aidoku Conversion → Response Models: maps response data
src/helpers.rs - Aidoku Conversion → REST URL Helpers: builds image URLs
src/helpers.rs - GraphQL Client → Suwayomi Server: sends GraphQL requests
src/api/graphql.rs - REST URL Helpers → Suwayomi Server: targets thumbnails
README.md - Chapter Pages → Suwayomi Server: gets page URLs
README.md - Image Requests → Suwayomi Server: fetches images