# Grimoire v1.7.0 - Building out more TTRPG tools — retained record

> Retained reddit record from reddit:selfhosted.

Canonical: https://highsignal.app/data/records/c427919f74f5d110

[← sources](https://highsignal.app/data)


source: [reddit](https://highsignal.app/data/reddit) (reddit:selfhosted)  published 2026-09-16 17:53 ingested 2026-09-17 02:37

[original source ↗](https://www.reddit.com/r/selfhosted/comments/1wi4iaz/grimoire_v170_building_out_more_ttrpg_tools/)

## retained text



```
Grimoire has long had support for organizing maps and tokens alongside being great at reading and organizing all your TTRPG books. But I'm building to something bigger, and have added some new tools to that end.

**A token editor.** Now you can edit the tokens you have uploaded to grimoire directly in the application, no need to download and then re-upload to a different service, only to download again and re-upload it to your grimoire campaign. And do you have a favorite map and token artist who has created hundreds of frames for your tokens? Well now you can put those frames to good use.

**A Map Editor.** With most VTT's supporting uvtt files, you can now take your boring old 2d pngs and jpgs and make them into uvtt files in the application. Need to edit a uvtt and add some lights, delete a wall, Grimoire makes this process a lot easier now. The map editor is designed to be fast and responsive, so you don't have to deal with the overhead of editing a map in a full VTT which can be slow.

  
No Grimoire is not becoming a VTT. The ultimate goal is to provide a solution to send your content to the VTT of your choice. There are dozens of great options to choose from, and each caters to a different style of group, GM, and players. Grimoire is for organizing and managing your content (especially your pdfs and improving how you read and search them), and is designed to be flexible to your needs and wants.

**Grimoire:** [https://github.com/hunter-read/grimoire](https://github.com/hunter-read/grimoire)

*Don't know anything about Grimoire?*

Well, Grimoire is a solution to your TTRPG file management woes, it makes searching, reading, organizing and sharing all your resources a lot easier.

* Self-host your entire TTRPG library, and share with your players. (except with the Rogue, he already has your library, your battlemaps, and your browsing history anyways)
* Browse and read from any device. Grimoire installs as a PWA so you can pretend to be doing something useful when it is the Warlock's turn and he has been spending the last 30 min trying to figure out what spell to cast, even though we both know he is going to cast Eldritch Blast again.
* Not just PDFs anymore. EPUB, DjVu, comic archives (CBZ/CBR/CB7/CBT), and plain text all open in the same reader. Your one scanned zine from 1998 is welcome here.
* Full-text search across every page of every book instantly, find that one rule without knowing which book it's in. Seriously, I love physical books, but as a hoarder of 40+ TTRPG's, I can't always find what I'm looking for.
* Organized automagically, just drop files in folders, Grimoire figures out the game system and category. I have trapped a wizard inside the code using blood magic. While this makes organizing easier, they are really opinionated about folder structure. There's now an in-app file manager too, so you can create folders, upload, move and rename without arguing with the wizard directly.
* Built-in reader with mobile-friendly page-by-page rendering. Seriously have you ever tried to read a 400 page pdf on your phone? It sucks. Hell large pdfs chug on most computers, needing more RAM than anyone can afford with these prices. Pages render server-side, so your phone just gets images.
* Campaign tracker for GMs and Players. Full wiki-style notes with templates and import/export, player invitations, guest invites for the one friend joining a single game, linked resources, and recurring schedules you can subscribe to from your actual calendar app. And we all know that scheduling is the real BBEG of playing TTRPGs.
* Maps, tokens, audio, and 3D models. Browse and tag battlemaps, character tokens, ambient tracks, and STLs, and attach them to campaigns so you never lose track of them. Audio has a persistent pop-out player with a queue, plus a floating grid of one-tap pads for one-shot sounds over the music. Save named playlists and boards to your account, so the board you built at home is there at the table.
* Support for community add-ons that offer more themes, campaign note templates, or metadata scrappers that can fill in system and book metadata from external sources, with a field-by-field diff before anything gets written, or provide new themes
* Built for docker and supports OIDC. Because not every homelab sorcerer wants to fiddle around with building from source or configuring auth.

I built this project with lots of love, and it's not my first TTRPG related project. Feedback is welcome.

I do use AI in this. I am a software developer who has been doing this for a long time and take great care in keeping this project secure, responsive, and at a high standard of code quality. AI is just another tool to speed up development, automate the boring parts, test bugs, and catch my mistakes. If you don't like AI and are annoyed that I used it, then just code your own application from scratch, this project was developed as a personal endeavor that I'm happy to share with others.
```



document fetched 2026-09-17 00:29 · canonical https://reddit.com/r/selfhosted/comments/1wi4iaz/grimoire_v170_building_out_more_ttrpg_tools
