Deploy Now

Stars

196

Forks

14

Watchers

4

Developer links

Atsumeru

Atsumeru is the bookshelf server for people whose manga and comic collection lives in CBZ files scattered across drives: point it at the folders and it becomes a tidy library you can read from anywhere. Series organize themselves into auto categories, custom categories, and metacategories, and metadata edits are painless, with automatic import from ComicInfo.xml and book_info.json files and parsing from supported catalogs when you want richer records. Reading happens in native apps for Windows, Linux, Mac, and Android, or in the built-in WebUI, and two-way history synchronization keeps your place when you move from desk to phone. Whole series download inside supported apps for offline reading, which turns a commute into a chapter backlog clearing session. Multiple users get separate histories and powerful access controls, so a household shares one server without sharing reading progress or seeing each other's shelves. A documented REST API with Swagger on board covers automation and custom clients. The server runs as a single jar or a Docker container on port 31337, small enough for the spare machine already holding the files. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. MIT licensed.

Atsumeru

Benefits

  • Your Comic Files, As A Library
  • Folders of CBZ and CBR archives become an organized, browsable library with categories and metadata, replacing filename archaeology across drives and cloud folders.
  • Read Anywhere, Resume Everywhere
  • Native apps and the WebUI share two-way history sync, so a chapter started on the desktop continues on the phone exactly where you stopped.
  • A Server The Whole House Uses
  • Multiple users keep separate histories and access controls, letting one installation serve a family's different tastes without progress or shelves colliding.
  • Metadata Without The Busywork
  • ComicInfo.xml and book_info.json import automatically, catalogs can supply richer records, and the editor fixes the rest, so covers and series data stay right.

Features

  • Category System
  • Autocategories sort new series on arrival, custom categories express your own order, and metacategories group collections into bigger shelves.
  • Metadata Editing And Import
  • Edit series and archive metadata directly, auto-import ComicInfo.xml and book_info.json, or parse details from supported catalogs.
  • Native Apps And WebUI
  • Read on Windows, Linux, Mac, and Android apps or in the browser, with whole-series downloads for offline reading in supported apps.
  • Two-Way History Sync
  • Reading progress synchronizes both directions between server and clients, keeping place and history consistent across devices.
  • Multi-User Access Controls
  • Create users with separate histories and powerful permissions over what each account can see and manage.
  • REST API With Swagger
  • A documented API and Swagger UI on the server port support automation, integrations, and third-party client development.

Apps Similar to Atsumeru