# Grimoire

> A self-hosted web app for organizing and reading your tabletop RPG PDF collection with full-text search, maps, tokens, audio, and campaign management.

- **Category:** Book Management
- **Licence:** GPL-3.0
- **Latest version:** v1.9.2
- **Open source:** oss
- **Languages:** Typescript, Python
- **Platforms:** Docker, Docker Compose
- **Tags:** library, SQLite, PDF, Ocr, Audio Player, Map Editor, Docker, Self Hosted, Rpg, Ttrpg, Campaign Manager, Token Editor

## Description

Grimoire is a self-hosted web application for organizing a personal tabletop RPG collection. Point it at a directory of PDFs, maps, tokens, audio files, and 3D models, and it creates a searchable library you can reach from any device. Each PDF page is indexed with SQLite FTS5, including scanned books via OCR. The software provides a page-by-page reader with pinch-to-zoom and spread view, a map gallery with Universal VTT editing for dynamic lighting, a token editor for making VTT-ready tokens, and an audio library with a persistent player and soundboard. Campaign features include a markdown wiki, character sheets, and scheduling. The app runs in a single Docker container, mounts your existing library read-only by default, and supports OpenID Connect for single sign-on with providers such as Keycloak, Authentik, and Auth0. The project uses the GPL-3.0 license.

## Links

- [Homepage](https://github.com/hunter-read/grimoire)
- [Website](https://grimoirecodex.org)
- [Docker](hunterreadca/grimoire)
- [Demo](https://demo.grimoirecodex.org)
- [Documentation](https://docs.grimoirecodex.org)
- [GitHub](https://github.com/hunter-read/grimoire)
- [Discord](https://discord.gg/9Sd4CGZC63)

---
Source: https://selfhost.directory/project/grimoire-2