Skip to content

Comic libraries

A comic library covers comics, manga, manhwa, webtoons, and light novels. Orb reads the archives in place and streams pages (or EPUB chapters) on demand — nothing is unpacked to Orb's data volume.

To create one, add a Comic root under Admin → Libraries (see Your library).

Supported formats

.cbz, .cbr, .zip, .rar, .epub, .pdf

PDFs are catalogued and downloadable, but not page-rendered in the in-browser reader.

Folder layout

The ingester groups files by directory: one directory = one series, and each archive file inside it is treated as one chapter / issue / volume. Order is taken from the filenames, so number them consistently.

Comics/
  Berserk/
    Berserk v01.cbz
    Berserk v02.cbz
  Chainsaw Man/
    Chainsaw Man 001.cbz
    Chainsaw Man 002.cbz
  The Wandering Inn/
    The Wandering Inn - Volume 1.epub

Reading & progress

The web reader streams pages directly from the archive, with layouts suited to both paged comics and long-strip webtoons. Reading progress is tracked per chapter.

You can also link an external tracker under your account so that finishing a chapter pushes progress back automatically. AniList is supported today — paste a personal AniList access token in your settings, and completed chapters sync via AniList's reading list.

Metadata enrichment

Comic series are enriched against several providers in merge mode, so fields combine across sources:

  • Manga / anime sources (no credentials): MangaDex, AniList, MangaUpdates, Kitsu, Jikan (MyAnimeList).
  • Western comic sources (free credentials): Comic Vine (API key), Metron (account), and Marvel (public + private keys, Marvel-published titles only).

Configure credentials under Admin → Plugins and choose providers per library — see Metadata plugins.

Next steps