Grimmory

AGPL-3.0
Platform
Web Docker Self-hosted
Licence
AGPL-3.0 Open source
Grimmory

Overview

Grimmory is a self-hosted library for a mixed collection of ebooks, comics, audiobooks and PDFs. It scans the files you already own, looks up covers and descriptions from public catalogues, and serves everything through a browser interface with its own reader, so the same shelf is available on a phone, a tablet or a work laptop without a cloud account. A Kobo, an OPDS app or KOReader can pull from it as well.

Formats it keeps together

Most self-hosted libraries pick one medium. Grimmory keeps four side by side: EPUB, MOBI, AZW, AZW3 and FB2 for ebooks; PDF for documents; CBZ, CBR and CB7 for comics; and M4B, M4A, MP3 and OPUS for audiobooks. All of them end up in the same catalogue and the same search.

Features

  • Built-in reader — PDFs, EPUBs and comics open in the browser with annotations, highlights and reading-progress tracking; nothing has to be downloaded to a device first.
  • Smart Shelves — hand-built shelves plus dynamic ones driven by rules, tags and full-text search.
  • Metadata lookup — covers, descriptions, reviews and ratings fetched from Google Books, Open Library and Amazon, each field editable by hand.
  • Device sync — connect a Kobo, point any OPDS-compatible app at it, or sync progress with KOReader.
  • BookDrop — drop files into a watched folder and Grimmory detects, enriches and queues them for review before they enter the library.
  • Multi-user accounts — separate shelves, progress and preferences per person, with local accounts or OIDC for an existing identity provider.
  • One-click sharing — send a title to a Kindle, to an email address, or to another user on the same instance.

Running it

The documented route is Docker Compose: one container for the application and a MariaDB container behind it, with volumes for the book directory, the BookDrop folder and application data. Release images are published as grimmory/grimmory on Docker Hub and on GHCR, with nightly builds from the development branch. A Helm chart and Podman Quadlet units are in the repository for Kubernetes and rootless Podman deployments.

Set DISK_TYPE=NETWORK when the library sits on an NFS or SMB mount: file operations that would move or delete files from the interface are then disabled, while reading, metadata and sync keep working. API reference documentation is off by default and can be exposed at /api/docs with API_DOCS_ENABLED=true.

Alternatives

For comics specifically, Kavita is the closest match; Calibre-Web is the established choice for an EPUB library with OPDS and a browser reader. Grimmory’s difference is holding ebooks, comics and audiobooks in one catalogue behind one reader.

Explore More Categories

Sign In

Register

Reset Password

Please enter your username or email address, you will receive a link to create a new password via email.