[Project] Issued - Self-hosted comic library server (OPDS + web reader)

Last year I built this for my personal comics collection and figured the selfhosted community might dig it. I tried different softwares but:

  • I didn't like the stack they used (java, .net, ...)
  • I didn't like that they force you to organize comics like they want. I have my own way of structuring my collection.
  • They looked old and bloated with stuff I will never use.

What it does

Dead simple comic server for CBZ/CBR files. Scan your folders → serve via OPDS → read on any device.

The good bits

  • Zero reorganization - keeps your existing folder structure
  • Auto-monitoring - detects new files in real-time (watchdog)
  • Dual access - OPDS for mobile apps (Panels/Chunky/...) + built-in web reader
  • Metadata support - parses ComicInfo.xml, editable via web UI
  • Reading progress - Shows what you are currently reading
  • Ongoing series – Mark active series and quickly see new issues, totals, and possible gaps
  • Light and dark themes – Follow your system preference or switch manually
  • Display Options - zoom, fit, expand, mosaic... different ways to look at your comics

Stack

Python/FastAPI backend, SQLite + Alembic migrations, Jinja2 templates, vanilla JS frontend (Tailwind). Uses rarfile for CBR, Pillow for thumbnails, SQLModel for ORM.

Multi-arch Docker image (amd64/arm64) or PyInstaller binaries for Mac/Linux/Windows.

Links

MIT licensed.

Ofc I'm open to any constructive feedback.

Enjoy✌️

submitted by /u/metalogico
[link] [留言]