Deploy Now

Stars

108

Forks

16

Watchers

3

Developer links

Issued

Issued is a self-hosted comic library server: point it at the folder of CBZ, CBR, CB7, and PDF comics already sitting on your server and the whole collection becomes browsable and readable from any device. Point it at your existing folders and it keeps your folder structure exactly as it is, scanning automatically when new issues appear and generating cover thumbnails so you can see what a file is before opening it. Read in the browser with the built-in web reader on desktop or mobile, with light and dark themes, or connect reader apps such as Panels, Chunky, KyBook, and Moon+ Reader through the standard OPDS catalog at /opds/. OPDS-PSE 1.2 page streaming lets compatible apps read individual pages as JPEGs without downloading whole archives, and OpenSearch discovery lets clients find library search automatically. Edit metadata in place using ComicInfo.xml data, mark series as ongoing to spot new issues, totals, and possible gaps, and use Continue Reading and Last Added views to resume the latest issue in progress or start the next unread one. An optional reader password protects browser access, and one Docker command on port 8181, with unrar included for CBR files, gets the whole library online. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. MIT licensed.

Issued
Issued
Issued
Issued
Issued

Benefits

  • Your folders stay untouched
  • Issued serves your collection exactly as it sits on disk, keeping your existing folder structure instead of importing or renaming files, and detects new comics automatically when they appear.
  • Read on every device
  • The built-in web reader works in any browser on desktop or mobile, while the standard OPDS catalog connects Panels, Chunky, KyBook, and Moon+ Reader with OpenSearch discovery built in.
  • Pages stream, archives stay
  • OPDS-PSE 1.2 page streaming serves individual pages as high-quality JPEGs converted with Pillow at quality 95, so compatible apps can read without downloading complete comic archives first.
  • Series gaps made visible
  • Marking a series as ongoing surfaces new issues, totals, and possible gaps at a glance, and Continue Reading resumes the latest issue in progress or starts the next unread one.

Features

  • Automatic library scanning
  • The scanner finds CBZ, CBR, CB7, and PDF files, detects the real container from file contents even when misnamed, extracts pages, and generates cover thumbnails automatically.
  • OPDS catalog with PSE
  • A standard Atom OPDS catalog with browse, search, recent additions feed, original downloads, and OPDS-PSE 1.2 page streaming for compatible reader applications.
  • ComicInfo metadata editing
  • Metadata is extracted from ComicInfo.xml or PDF metadata and can be edited in place, so series, titles, and credits stay correct across every reader.
  • Built-in web reader
  • The browser reader at /reader/ tracks reading progress, follows light and dark themes, and works on mobile browsers without installing any application.
  • One-command Docker setup
  • The ghcr.io image on port 8181 bundles unrar for CBR support, waits safely when the comics mount is not ready, and leaves the database untouched until the library is visible.

Apps Similar to Issued