Sign inSign up

lincalinca/suparr

By lincalinca

•Updated 3 months ago

A comicbook library manager for collectors and readers. Scan barcodes, catalogue your collection.

Image
0

559

lincalinca/suparr repository overview

⁠Suparr

A self-hosted comic book library manager for collectors and readers. Scan barcodes, catalogue your collection, track completion, and discover new series — all from a single lightweight container.

⁠Quick Start

docker run -d \
  --name suparr \
  -p 61600:61600 \
  -v ./config:/config \
  -v /path/to/comics:/comics \
  lincalinca/suparr:latest

Then open http://localhost:61600⁠.

⁠Features

  • 📚 Library Management — organise series, track issues, monitor completion
  • 📷 Barcode Scanner — scan-to-shelve with your phone camera
  • 🔍 Metadata Matching — powered by the Grand Comics Database (GCD), covering Western, Manga, Indie, and more
  • 📊 Collection Insights — spending trends, key issue spotting, rarity index, gap radar
  • 🗂️ Media Management — CBZ/CBR file matching, naming conventions, health checks
  • 🔄 Want Lists & Pull Lists — track what you're hunting and what's on order
  • 🏷️ Physical Copy Tracking — grades, slabs, locations, lending, insurance packs
  • 📖 Reading Order Tools — arcs, crossovers, and reading compass

⁠Configuration

Mount a .env file or pass environment variables:

VariableDescription
SUPARR_PORTListen port (default: 61600)
SUPARR_CONFIG_DIRConfig/DB path (default: /config)
SUPARR_COMICS_DIRComic files path (default: /comics)
COSMOS_ENDPOINT(Optional) Azure Cosmos DB endpoint for GCD metadata
COSMOS_KEY(Optional) Azure Cosmos DB key
COSMOS_DATABASE(Optional) Cosmos DB database name (default: suparr)

⁠Volumes

PathPurpose
/configSQLite database, settings, encryption keys
/comicsYour comic library root

Tag summary

Content type

Image

Digest

sha256:1ca09d107…

Size

9.7 MB

Last updated

3 months ago

docker pull lincalinca/suparr