[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

• Website: https://useissued.com
• Repo: github.com/metalogico/issued
• GHCR: ghcr.io/metalogico/issued

MIT licensed.

Ofc I'm open to any constructive feedback.

Enjoy✌️