A self-hosted web app that indexes your tabletop RPG PDFs, maps, tokens, audio and models into one searchable library.
325+7 this week19PythonGPL-3.0Updated yesterday
Kruptein/PlanarAlly
A self-hostable web tool for running virtual battlemaps with dynamic lighting, player vision and fog for tabletop RPG sessions.
Open-source alternative to:Roll20
Foundry VTT
- Stars
- 563
- Forks
- 98
- Open issues
- 112
- Last commit
- 10 days ago
What is it?
PlanarAlly is a web-based virtual tabletop focused on battlemaps for TTRPGs such as Dungeons & Dragons. Game masters and players use it to display maps, place tokens and run encounters from a browser.
The tool can be self-hosted on your own machine or server, and it can also be run in a fully offline setup for games played without internet access. Maps are organized into layers and floors, and the canvas is effectively unlimited in size.
It includes dynamic lighting and player vision, so each token only reveals what it can see. A simple initiative tracker is also included.
Key features
- 01Self-hosted deployment on your own infrastructure
- 02Fully offline setup supported
- 03Layers for organizing scenes
- 04Dynamic lighting with player vision limits
- 05Multi-floor maps with the ability to look down to lower floors
- 06Built-in initiative tracker
Use cases
- Running D&D sessions online with a shared battlemap
- Playing in-person games offline at a table with a projected map
- Hosting a private game server for a friend group
- Prototyping encounters with light and vision effects
Quick start
- 1
Download the app from the releases page
- 2
See the documentation for install and run instructions
Things to know
- Development setup details are in a separate CONTRIBUTING document, not in the README.
In collections
Topics
FAQ
- What is PlanarAlly?
- A self-hostable web tool for running virtual battlemaps with dynamic lighting, player vision and fog for tabletop RPG sessions. PlanarAlly is a web-based virtual tabletop focused on battlemaps for TTRPGs such as Dungeons & Dragons. Game masters and players use it to display maps, place tokens and run encounters from a browser.
- Is PlanarAlly free to use? What license does it have?
- PlanarAlly is open source under the MIT license. Check the license terms before using it in commercial products.
- Is PlanarAlly still maintained?
- Actively maintained. The last commit to PlanarAlly was on Oct 28, 2026.
- What can I use PlanarAlly for?
- Running D&D sessions online with a shared battlemap Playing in-person games offline at a table with a projected map Hosting a private game server for a friend group Prototyping encounters with light and vision effects
- How do I install PlanarAlly?
- Download the app from the releases page See the documentation for install and run instructions
- Where can I get PlanarAlly?
- The source code and installation instructions are on GitHub: https://github.com/Kruptein/PlanarAlly
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A self-hosted minimalist app for mapping points of interest on interactive maps and planning multi-day trip itineraries.
2K+2 this week126TypeScriptMITWell maintainedUpdated last month
A JavaScript engine for building turn-based games with automatic state management and online multiplayer.
12.5K+4 this week835TypeScriptMITUpdated 8 days ago
A PHP library for representing and manipulating collections, with typed collection and map classes inspired by the Java Collections Framework.
1.2K54PHPMITUpdated 3 months ago
Open-source, self-hosted scheduling platform (MIT-licensed community fork of Cal.com) for booking meetings and managing calendars.
49.8K+188 this week15.6KTypeScriptMITWell maintainedUpdated 4 days ago
Open-source, self-hostable social media scheduling tool for planning, posting, and analyzing content across many platforms, with AI and API integrations.
41.1K+748 this week7.8KTypeScriptAGPL-3.0Updated 6 hours ago