Stars
Forks
Watchers
Developer links
Grimmory
Consolidate fragmented collections of digital novels, graphic novels, manga, and audiobooks into Grimmory, an open-source media library server that combines automated file sorting with rich in-browser reading environments. The server indexes diverse media formats including EPUB, MOBI, AZW3, FB2, PDF, CBZ, CBR, CB7, M4B, and MP3 files across isolated storage directories. Readers explore literature through specialized browser viewports that provide customizable typography, CFI highlight annotations, two-page comic spreads with right-to-left manga modes, and chapter-based audiobook playback with sleep timers. Automated BookDrop watch folders ingest incoming files, retrieving book covers, author biographies, and community ratings from Google Books, Open Library, and Amazon APIs. Dynamic Magic Shelves organize catalogs automatically using nested boolean rule trees that filter books by page counts, genres, release dates, or narrator identities without server reload overhead. External e-readers access media catalogs through standard OPDS feeds or native Kobo and KOReader synchronization endpoints that match documents by binary content hashes. Built-in email delivery sends formatted books directly to Kindle devices with a single click, while OpenID Connect authentication enforces granular multi-user library permissions. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. GNU AGPLv3 licensed.
Benefits
- Unified Multi-Format Media Readers
- Access dedicated in-browser readers for EPUB, PDF, and CBZ comics with right-to-left manga modes, alongside an audio player supporting chaptered M4B audiobooks, playback speed controls, and persistent progress tracking.
- Automated BookDrop Catalog Ingestion
- Drop raw ebook and comic files into monitored filesystem directories to trigger automated background extraction, file hash deduplication, and metadata enrichment from Google Books and Open Library databases.
- Hardware E-Reader Progress Synchronization
- Synchronize reading milestones bidirectionally with KOReader devices using binary content hashing while delivering library shelves directly to Kobo hardware over authenticated wireless sync endpoints.
- Dynamic Rule-Based Magic Shelves
- Construct client-side boolean filter trees that evaluate book metadata, reading statuses, page lengths, and audiobook durations to populate automated dynamic shelves without requiring manual tagging.
Features
- Komga-Compatible Streaming API
- Provides Komga protocol emulation endpoints, enabling third-party comic reader applications like Tachiyomi and Komelia to stream individual pages from CBZ and CBR archives on demand.
- Standard OPDS Catalog Server
- Exposes an OPDS XML catalog endpoint supporting search, pagination, and direct downloads across any modern mobile reading app or standalone e-ink tablet.
- Direct Kindle Email Delivery
- Integrates outbound SMTP routing to convert and transmit selected ebook titles straight to configured Amazon Kindle user addresses with one click.
- Multi-User OIDC Authentication
- Integrates enterprise OpenID Connect identity providers and role-based permissions, allowing family members or team users to maintain private shelves and personal reading histories.
- Granular Library Access Permissions
- Partitions distinct collections into independent libraries with customizable format filters, automatic directory watch toggles, and per-user visibility privileges.
- Embedded and External Metadata
- Parses internal OPF metadata schemas and embedded comic info XML records, with options to prioritize external companion sidecar files during background scans.