rayderc/comicorbit repository overview

⁠ComicOrbit

Self-hosted manga & comic library. Search, download, and read CBZ archives from your own server — no subscriptions, no tracking.

⁠Features

• Netflix-style home page — Continue Reading, Recently Added, and Favorites rows
• Login-gated — every page requires authentication; first launch auto-redirects to account setup
• Download from MangaDex, MangaFreak, and GetComics — MangaFreak is the default manga source; parallel page downloads with live progress
• Built-in reader — CBZ pages streamed from disk; tap left/right to turn pages, tap the middle to toggle the toolbar; keyboard arrows also work
• Per-user read progress — picks up exactly where you left off
• Favorites & custom collections — star series and group them however you want
• Tag / type / status filters in the full library view
• Multi-user — admin creates additional accounts from the dashboard
• PWA / Add to Home Screen — installs as a full-screen app on iOS and Android with a proper icon and offline shell
• Single-container Docker — SQLite database, auto-generated session secret, bind-mount volumes for your files

⁠Quick start

# docker-compose.yml
services:
  comicorbit:
    image: rayderc/comicorbit:latest
    container_name: comicorbit
    restart: always
    ports:
      - "7080:7080"
    volumes:
      - ./config:/config   # SQLite DB + session secret
      - ./Manga:/Manga     # Downloaded manga chapters
      - ./Comics:/Comics   # Downloaded comics

docker compose up -d
# then open http://localhost:7080

On first launch you'll be redirected to the setup page to create the admin account (pre-filled as admin / admin — change the password after you log in).

⁠Environment variables

⁠Download sources

⁠Disk layout

/config/
  comicorbit.db          ← SQLite (users, series, chapters, queue, progress)
  .session_secret        ← auto-generated 48-byte secret

/Manga/
  One Piece/
    cover.jpg
    One Piece - 1.cbz
    One Piece - 2.cbz

/Comics/
  Batman/
    cover.jpg
    Batman - 1.cbz

⁠Development

git clone https://github.com/RayderC/ComicOrbit.git
cd ComicOrbit
npm install
npm run dev        # http://localhost:7080

Requires Node.js 20+. The SQLite native module is compiled during npm install.

⁠Stack

• Next.js 16 (App Router + Pages Router) · React 19 · TypeScript
• SQLite via better-sqlite3
• iron-session for encrypted cookie auth
• cheerio for HTML scraping
• Cyberpunk/amethyst theme

⁠License

MIT