Agent skill · software engineering · aradotso
grimmory-self-hosted-library
Expert knowledge for setting up, configuring, and extending Grimmory — a self-hosted book library manager supporting EPUBs, PDFs, comics, Kobo sync, OPDS, and multi-user management.
Why this skill is useful
Adds a complete Docker setup and configuration scripts for deploying the Grimmory library manager, which are not commonly found in public documentation.
What it needs
Requires docker, docker-compose installed locally. About 6k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
Grimmory Self-Hosted Library Manager Skill by ara.so — Daily 2026 Skills collection. Grimmory is a self-hosted application (successor to BookLore) for managing your entire book collection. It supports EPUBs, PDFs, MOBIs, AZW/AZW3, and comics (CBZ/CBR/CB7), with a built-in browser reader, annotations, Kobo/OPDS sync, KOReader progress sync, metadata enrichment, and multi-user support. --- Installation Requirements Docker and Docker Compose Step 1: Create .env Step 2: Create docker-compose.yml Step 3: Launch Open http://localhost:6060 and create your admin account. --- Volume Layout --- Environment Variables Reference Variable Description Default --- --- --- USERID UID for the app process 1000 GROUPID GID for the app process 1000 TZ Timezone string Etc/UTC DATABASEURL JDBC connection string required DATABASEUSERNAME DB username required DATABASEPASSWORD DB password required DISKTYPE LOCAL or NETWORK LOCAL --- Supported Book Formats Category Formats --- --- eBooks EPUB, MOBI, AZW, AZW3 Documents PDF Comics CBZ, CBR, CB7 --- BookDrop (Auto-Import) Drop files into ./bookdrop/ on your host. Grimmory watches the folder, extracts metadata from Google Books and Open Library, and queues books for review. Flow: 1. Watch — Grimmory monitors /bookdrop continuously 2. Detect — New files are picked up and parsed 3. Enrich — Metadata fetched from Google Books / Open Library 4. Import — Review in UI, adjust if needed, confirm import Volume mapping required in docker-compose.yml: --- Network Storage Mode For NFS, SMB, or other network-mounted filesystems, set DISKTYPE=NETWORK. This disables destructive UI operations (delete, move, rename) to protect shared mounts while keeping reading, metadata, and sync fully functional. --- Java Backend — Key Patterns Grimmory is a Java application (Spring Boot + MariaDB). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/grimmory-self-hosted-library