Own your library.
Host it yourself.
Read it everywhere.

Self-hosted comic library with OPDS support. Drop your CBZ/CBR files in a folder, point Issued at it, read from your phone, tablet, or browser. That's it.

Download Quick start

OPEN SOURCE

# point it at your comics folder
$ ./issued init --library ~/Comics

# scan and generate thumbnails
$ ./issued scan

# done. go read your comics.
$ ./issued serve
OPDS → http://192.168.1.42:8181/opds/
Web → http://192.168.1.42:8181/reader/

What you get

No cloud, no subscription,
no nonsense.

Your folders, untouched

Issued reads your existing folder structure. No importing, no reorganizing. Your filesystem is already your library.

OPDS catalog

Standard OPDS feed works with Panels, Chunky, KyBook, Moon+ Reader, and dozens of other apps out of the box.

Built-in web reader

No app? No problem. Read directly in your browser on any device. Mobile-friendly, keyboard shortcuts included.

Live file monitoring

Drop a new comic file in your folder. Issued picks it up automatically — no rescanning needed.

Docker or standalone

One-liner with Docker Compose for your NAS, or download a single binary for macOS, Linux, and Windows.

ComicInfo.xml metadata

Reads embedded metadata automatically. Edit title, series, writer, and more from the web UI.

See it in action

Usable. Beautiful. Simple.

WEB READER

Read anywhere

Full-screen reader with page navigation, keyboard shortcuts, and a responsive layout that works on phones and tablets just as well as your desktop.

METADATA

Edit comic info in-place

If your files have ComicInfo.xml, Issued reads it. If they don't, you can fill in title, series, writer, and more right from the browser.

LIBRARY

Pick up where you left off

Continue reading your current comic or check what was recently added. Your library stays organized without any effort on your part.

Works with your favorite reader

Standard OPDS, zero lock-in

Connect any OPDS-compatible comic reader. Here are some popular ones:

Browser

Get started

Running in under a minute.

Choose your install method:

# clone the repo
$ git clone https://github.com/metalogico/issued.git
$ cd issued

# edit docker-compose.yml → set your comics path
# then:
$ docker compose run --rm issued init --library /comics
$ docker compose up -d

# that's it. open http://YOUR-IP:8181/reader/

# download from github releases (macOS/Linux/Windows)
$ chmod +x issued

# init, scan, serve
$ ./issued init --library ~/Comics
$ ./issued scan
$ ./issued serve

# open http://YOUR-IP:8181/reader/

What's next

Roadmap

Dark theme

A proper dark mode for late-night reading sessions.

Reading lists

Create and manage custom lists to organize your reading.

Own your library.Host it yourself.Read it everywhere.

No cloud, no subscription,no nonsense.