Self-hosted · open source · installable PWA

The *arr stack for manga.

Discover, grab, monitor and read. Self-hosted in one installable app. One image replaces the indexer, the grabber, the download client, the Cloudflare solver and the media server.

View on GitHub Self-host it →

CBZCBRimage foldersMangaDexMadaraMangaThemesiaManganato

koryomi
Koryomi home screen with a daily-picked series and recommendation rails
Koryomi vertical webtoon reader on mobile

The pitch

Prowlarrindexers
Sonarr / Radarrgrab & monitor
qBittorrentdownloads
FlareSolverrCF solver
Jellyfinserve & read
Koryomi koryomi.

Normally that's four or five containers
and a weekend of compose files. Koryomi is one image.

One app instead of a stack

The whole pipeline, folded into a single image.

Self-hosting manga the usual way means a pile of services: an indexer, a grabber that watches for new releases, a download client, a Cloudflare solver, and a media server to read it all. Koryomi folds discover → grab → monitor → serve → read into one. Point it at your library, add sources by URL, and it does the rest.

  • Prowlarr / Jackettindexers & search
    ✓Add a source by pasting its URL (engine auto-detected), plus bundled MangaDex, all searchable in Discover.
  • Sonarr / Radarrgrab + watch releases
    ✓Add to library, then a scheduled updater auto-grabs new chapters, per-series, on a configurable interval.
  • qBittorrentdownload client
    ✓Built-in chapter downloader writes clean CBZ, with offline PWA sync of your favorites.
  • FlareSolverrCloudflare solver
    ✓Bundled and wired in. Nothing to configure.
  • Jellyfin / Plexmulti-user server + apps
    ✓An OLED PWA reader: per-user progress, household leaderboard, offline, 2FA, and a Jellyfin-style admin panel.
Discover
Grab
Monitor
Serve
Read

Built to be opened

Every screen, designed for a true-black night read.

01 · The reader

A reader you'll actually want to open.

True-black OLED with a webtoon-first vertical reader: continuous multi-chapter scroll, pinch & double-tap zoom, AMOLED / sepia themes, per-series memory, auto-hiding chrome and full keyboard nav on desktop. Not a long-strip mode bolted onto a page-turn comics viewer.

  • Continuous, multi-chapter canvas
  • Pinch & double-tap zoom · reading themes
  • Remembers where every series left off
Vertical webtoon reader scrolling

02 · The library

Your whole shelf, organized and alive.

A fast scanner for CBZ, CBR and loose image folders (it reads ComicInfo.xml), with cover-art ambient theming, genres, an Updates feed with new-chapter badges, and discovery rails: For You, trending, and similar.

  • CBZ · CBR · folder scanner
  • Ambient cover-art theming
  • Updates feed + new-chapter badges
koryomi / library
Koryomi library grid

03 · Discover

Add a source by pasting a URL.

Auto-detect figures out the engine (Madara, MangaThemesia or Manganato), so a single paste reaches a whole family of sites. Search across sources and your own shelf, then add and grab in a click. No extension repos to wire up.

  • Engine auto-detection
  • Bundled MangaDex (official API)
  • Cross-source search
koryomi / discover
Koryomi discover and source picker

04 · For the household

A Jellyfin-style control room, with the security most manga tools skip.

Members & permissions, provider health, scheduled tasks, an activity feed and server settings. Behind it: argon2id passwords, rotating refresh tokens, login lockout, an audit log, session/device management and optional TOTP two-factor.

  • Per-user progress · favorites · streaks · leaderboard
  • 2FA · lockout · audit log · live sessions
  • Open-registration toggle & auto-update interval
koryomi / admin
Koryomi admin panel: members, roles and permissions

Why Koryomi

Most tools make you pick a side. This one does both.

A library server (Komga, Kavita) reads files you supply but can't fetch new chapters. A source app (Tachiyomi / Mihon, Suwayomi) fetches chapters but is Android-only or wraps them in a basic web UI. Koryomi is the rare one that does both, in an app that's a pleasure to use.

KoryomiKomga / KavitaTachiyomi / MihonSuwayomi
Self-hosted, multi-user server✓✓×Android app✓
Fetches new chapters from sources✓×you supply files✓✓
OLED design + webtoon-first reader✓basicmobilebasic
Installable PWA + offline, any device✓partialAndroid onlypartial
Per-user progress + household✓✓×limited
2FA · lockout · audit · sessions✓basic××
Add a source by pasting a URL✓n/aextensionsextension repos

Honest about it: Komga / Kavita are more mature for general library management, and Tachiyomi / Mihon list more individual sources. But Koryomi reads CBZ, CBR and loose folders (it skips PDF/EPUB on purpose), and its three engines each cover a whole family of sites, so "add by URL" reaches far more than the engine count suggests. Koryomi's edge is the combination: a polished, installable, multi-user reader that also fetches, with webtoons first-class.

Everything in the box

One image. A surprising amount inside.

Webtoon-first reader

Continuous scroll, zoom, AMOLED & sepia themes, per-series memory, auto-hiding chrome, keyboard nav.

Smart library

CBZ · CBR · folders, ComicInfo, genres, ambient theming, Updates feed.

Multi-user household

Accounts, per-user progress, favorites, avatars, streaks, a leaderboard.

Installable & offline

A real PWA: add to home screen, download & auto-sync favorites, read offline.

Serious security

argon2id, JWT + rotating refresh, lockout, audit log, sessions, optional TOTP 2FA.

Admin dashboard

Members, provider health, scheduled tasks, activity, server settings.

Self-host in minutes

Clone it. Point it at your library. Done.

One docker compose up brings up the reader, the API, the database and the Cloudflare solver together. No stack to assemble.

View the repo MPL-2.0 · runs anywhere Docker does
bash · koryomi 
// grab it and point LIBRARY_PATH at your manga
$ git clone https://github.com/AngeloSha/koryomi.git
$ cd koryomi
$ cp .env.example .env
$ docker compose up -d

// open http://localhost:3000, then create the admin account,
// add a source by URL, and start reading.
✓ koryomi-web   running
✓ koryomi-bff   running
✓ flaresolverr  running

Get the app

Add Koryomi to your home screen.

It's a real PWA, so it installs like a native app on any device, no app store required. Add it to your home screen and it opens full-screen, runs offline, and downloads chapters for the road.

iPhone & iPad

  1. Open koryomi.com in Safari
  2. Tap Share
  3. Choose Add to Home Screen

Android

  1. Open koryomi.com in Chrome
  2. Tap the menu, or the install prompt
  3. Choose Install app

Desktop

  1. Open it in Chrome or Edge
  2. Click the install icon in the address bar
  3. It opens in its own window

On the roadmap

Native App Store & Google Play apps are next.

The web app already does everything. Store-listed iOS and Android builds are the next step, and with enough community backing we can make them happen. Every contribution pushes Koryomi closer to the stores.

Back it on Ko-fi

Actively developed

On deck.

Push notifications

Get alerted the moment a followed series gets a new chapter.

Import your follows

Bring an existing list (Tachiyomi/Mihon backup or MangaDex follows) in one step.

OPDS feed

Browse & read Koryomi from other reader apps like Panels, Chunky, and friends.

Also exploring: unified library-and-source search · AniList progress sync · a first-run setup wizard.