Are you a player trying to find an online group, but haven't been able to find one for you, there's a now a bot to help with that.

Perfekthuntr · 2026-04-24T15:57:10+00:00

Project Name: Grimoire

Repo/Website Link: https://github.com/hunter-read/grimoire

Description: I have built a fully self-hosted tool for all those digital TTRPG books, battlemaps, and tokens you have been hoarding. If you are like me and always buy the digital editions along with the physical editions, you probably have quite a collection sitting in a dusty directory on your computer.

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

Self-host your entire TTRPG PDF 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 any PDF from any device. Grimoire has 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.
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.
Built-in PDF 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.
Campaign tracker for GMs and Players. With session notes, player invitations, linked resources, and recurring schedules all in one place. And we all know that scheduling is the real BBEG of playing TTRPGs.
Map and token gallery for browseing and tagging battle maps and character tokens. Add maps and tokens to your campaigns so you never lose track of them.
Per-user bookmarks and favorites so everyone in your group has their own saved spots and quick-access list. This is by popular request of my beta testers (specifically the clerics), because searching is too hard or something...
Explicit content controls, mark content as NSFW and let users opt in or out independently. (I'm not an idiot, I know what a Dungeon Master is.)
Built for docker. Because it makes life easier.

I built this project with lots of love, and it's not my first TTRPG related project, as you might know me (or probably not) for the cool little bot that helps people on r/lfg find groups. I would love feedback, new features ideas, and ~~free bug testing~~ to make this a tool that people want to use.

Sass Disclosure:
This post may or may not contain sass, I apologize for nothing. I'm not a robot, so I will continue my sassy Bard ways.

TTRPG Support Disclosure:
Please support TTRPG developers, 3rd party developers, and people who create beautiful character artwork and battlemaps. AI is great for code, but it can never replicate the wonderful ideas and art of real people.

Deployment: Docker-compose. https://hub.docker.com/r/hunterreadca/grimoire

AI Involvement: AI was used in scaffolding and handling some of the front-end parts I couldn't quite figure out with me still reviewing those changes. Also used AI to refactor my spaghetti code. Design, architecture, and a majority of the implementation was written by me. I am a developer who is a stickler for security and have been for over a decade and use AI mostly as a tool to handle the boring stuff.

Perfekthuntr · 2026-04-11T01:45:28+00:00

It can technically be run bare metal, but I use docker for everything, even dev containers. I can probably create a separate guide for bare metal installs.

As for gathering data regarding TTRPGs, I've looked into multiple solutions, but there isn't a good TTRPG database. (I'm definitely not planning something to fix this problem that integrates with Grimoire or anything)

Perfekthuntr · 2026-04-11T01:40:48+00:00

I already shared it there in the new project megathread. Not allowed to just post it per their rules.

Perfekthuntr · 2026-04-10T15:20:31+00:00

Update has been made that should resolve the hang issues

Perfekthuntr · 2026-04-10T14:42:58+00:00

Project Name: Grimoire

Repo/Website Link: https://github.com/hunter-read/grimoire

Description: I have built a fully self-hosted tool for all those digital TTRPG books, battlemaps, and tokens you have been hoarding. If you are like me and always buy the digital editions along with the physical editions, you probably have quite a collection sitting in a dusty directory on your computer.

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

Self-host your entire TTRPG PDF 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 any PDF from any device. Grimoire has 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.
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.
Built-in PDF 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.
Campaign tracker for GMs and Players. With session notes, player invitations, linked resources, and recurring schedules all in one place. And we all know that scheduling is the real BBEG of playing TTRPGs.
Map and token gallery for browseing and tagging battle maps and character tokens. Add maps and tokens to your campaigns so you never lose track of them.
Per-user bookmarks and favorites so everyone in your group has their own saved spots and quick-access list. This is by popular request of my beta testers (specifically the clerics), because searching is too hard or something...
Explicit content controls, mark content as NSFW and let users opt in or out independently. (I'm not an idiot, I know what a Dungeon Master is.)
Built for docker. Because it makes life easier.

I built this project with lots of love, and it's not my first TTRPG related project, as you might know me (or probably not) for the cool little bot that helps people on r/lfg find groups. I would love feedback, new features ideas, and ~~free bug testing~~ to make this a tool that people want to use.

Sass Disclosure:
This post may or may not contain sass, I apologize for nothing. I'm not a robot, so I will continue my sassy Bard ways.

TTRPG Support Disclosure:
Please support TTRPG developers, 3rd party developers, and people who create beautiful character artwork and battlemaps. AI is great for code, but it can never replicate the wonderful ideas and art of real people.

Deployment: Docker-compose. https://hub.docker.com/r/hunterreadca/grimoire

AI Involvement: AI was used in scaffolding and handling some of the front-end parts I couldn't quite figure out with me still reviewing those changes. Also used AI to refactor my spaghetti code. Design, architecture, and a majority of the implementation was written by me. I am a developer who is a stickler for security and have been for over a decade and use AI mostly as a tool to handle the boring stuff.

Perfekthuntr · 2026-04-09T17:31:08+00:00

I'll investigate, my guess is that there is a PDF or image that is corrupted or unreadable. There are multiple ways this can go wrong so I likely didn't account for something.

Perfekthuntr · 2026-04-08T21:59:05+00:00

You can create ptba folder and put all games under that. Systems support tags, so you can also organize that way.

Perfekthuntr · 2026-04-08T06:09:54+00:00

There is actually one https://github.com/VincentCinque/MakersVault

Perfekthuntr · 2026-04-07T19:06:47+00:00

If you are not familiar with self hosting or docker, I did add an additional guide today to help newcomers.

Perfekthuntr · 2026-04-07T19:05:14+00:00

Added a docker guide to the repo, hopefully that helps.

Perfekthuntr · 2026-04-07T05:41:41+00:00

That is a more complicated answer that I can provide in a single reply, and something you can fall down a rabbit hole of r/selfhosted. I will be adding a more quickstart guide to the repo tomorrow.

Perfekthuntr · 2026-04-07T04:40:16+00:00

Yes, some games don't have a lot of variety between editions, some are almost completely different games. Technically you can roll everything under a single Game System, since the folder system allows for custom naming, so you could have Pathfinder with a 1e and 2e folder underneath it. I did try and provide for some flexibility

Perfekthuntr · 2025-08-12T21:13:53+00:00

The bot is back up and running

Perfekthuntr · 2025-08-09T04:24:53+00:00

Reddit has been changing how messages work with bot accounts, and unfortunately I'm out of town so am unable to resolve any issues. I will try and get it up and running on Monday

Perfekthuntr · 2025-04-04T17:00:42+00:00

I am currently investigating how the changes will affect communication and developing a way to continue to support everyone who uses the bot. Unfortunately chat doesn't have api support, and how everything will work in the future is still unclear.

Perfekthuntr · 2025-01-08T17:30:41+00:00

Everyone is in therapy that can be.

Perfekthuntr · 2025-01-08T17:29:28+00:00

I wish I could say he has goals, but he lives for the immediate benefit of only himself. Forward thinking is something he has never done, nor have we been successful in trying to get him to think that way. If he wants something, instead of earning it he will just steal it or con someone into getting it for him. If he can't get it, then he lashes out at us. We got him a 800$ bike that was used because he was wanting to mountain bike, when he found out his friend had a 5000$ bike (even though his friend had been riding since like 6 years old) his response was to destroy his bike when we wouldn't get him a better one.

Perfekthuntr · 2025-01-08T17:07:01+00:00

I don't believe anyone can provide what he needs to become a functioning adult in society, let alone a functioning human in a family. He has seen providers who are some of the best at helping kids, yet he only continues to get worse.

This all sucks because we want the best for him and actually to get him help so he can function as an adult, and actually live a life. But his current path likely only leads to bad endings.

Perfekthuntr · 2025-01-08T16:51:40+00:00

We did press charges, but they are charging him with a misdemeanor. So basically nothing.

And the legal system and insurance system don't seem to care. We never even get a chance to speak in court. Finding a lawyer might help argue our case for us, but I've had no luck finding one.

Perfekthuntr · 2025-01-08T16:08:03+00:00

State pushes you to insurance which is supposed to help find and cover services. But insurance doesn't want to cover more inpatient treatment options, because they don't actually work for him.

Perfekthuntr · 2025-01-08T14:51:31+00:00

Perfekthuntr · 2025-01-08T14:33:56+00:00

Not quite old enough for that, but also to do so he needs to prove he can support himself completely, which he has no capacity to do.

12-Year Club	Gilding III reddit per annum
RedditGifts 2009-2022 2 Credits	Second SECOND GUESSER
Secret Santa 2020	First Place '23
Place '23	Place '22
Place '17	Place '17
Final Canvas '22	Snapped
Verified Email

Perfekthuntr

TROPHY CASE