🐉 Dungeon Master Tool

A portable, offline-first DM tool designed for dual-monitor setups.
Manage combat, track timelines, and project a rich campaign wiki seamlessly.

✨ Check out our over-engineered amazing website here! ✨




Supported Languages:
🇺🇸 English | 🇹🇷 Türkçe | 🇩🇪 Deutsch | 🇫🇷 Français

---

📢 Developer Note: You can find current priorities and known bugs in TODO.md.

Due to personal time constraints, updates might be slower recently. However, I am doing my best to stick to the roadmap and implement planned features. Thank you for your support!

---

✨ Highlights

📺 Dynamic Projection	🌫️ Fog of War	🧠 Mind Map
Drag & drop images to project instantly to a second screen.	Draw fog to hide secrets on the battle map. Persists per encounter.	Infinite canvas to link notes, NPCs, and create story workspaces.

🎵 Adaptive Audio	⚔️ Combat Tracker	🌍 System Agnostic
Layered music with intensity sliders. Create custom themes easily.	Manage initiative, HP, and conditions integrated with the map.	Built-in 5e SRD/Open5e browser, but adaptable to any system.

---

🚀 Core Features Guide

• 📺 Project to Players: Click "Toggle Player Screen". Drag any image (NPC/Map) to the "Drop to Project" bar at the top.
• 🌫️ Fog of War: In the Session Tab, click "Fog". Left-click to hide, Right-click to reveal.
• 🧠 Mind Map: Right-click on the canvas to add Nodes or Workspaces. Middle-click to pan.
• 🎵 Soundpad: Open the panel, select a theme (e.g., "Forest"), and use the Intensity Slider to shift music dynamically.

---

🗺️ Roadmap & Status

✅ Ready to Use

• Projector: Multi-image split view & Battle Map sync.
• Maps: Video map support (.mp4), Fog of War, Grid.
• Campaign: Rich text notes, binary storage (.dat), Timeline tracker.
• Customization: Theme Engine (10+ themes), English/Turkish localization.
• Audio: Custom Soundpad with Theme Builder.

🚧 Coming Soon

• Generators: Random NPC & Encounter creators.
• Tools: Image-to-Note (OCR) transformer.
• Content: Pre-built worlds & "One-Click" campaign setups.
• Online: Hosted servers for remote play.

---

🚀 Installation

🪟 Windows

1. Download DungeonMasterTool-Windows.zip here.
2. Extract the folder and run DungeonMasterTool.exe.

🐧 Linux

Preferred

1. Download DungeonMasterTool-Linux.zip here.
2. Extract the folder and run DungeonMasterTool.

Manual

git clone https://github.com/elymsyr/dungeon-master-tool.git
cd dungeon-master-tool
bash installer/install.sh  # (Use install-arch.sh for Arch Linux)
./run.sh

🍎 MacOS Installation & Security Note

Since this is an open-source project and not signed with an official Apple Developer account, you need to manually bypass the "unverified developer" warning.

Click here to download DungeonMasterTool-MacOS.zip

Steps to run the app:

1. Extract the downloaded .zip file.
2. Drag DungeonMasterTool.app to your Applications folder.
3. Open Terminal (Cmd + Space, type 'Terminal') and run the following command to remove the quarantine flag:

   sudo xattr -rd com.apple.quarantine /Applications/DungeonMasterTool.app

4. Launch: You can now open the app from your Applications or Launchpad.

---

📸 Gallery

---

📣 Feedback / İletişim

I read every piece of feedback. Whether it's a bug report or a feature request, please reach out!
Her geri bildirimi okuyorum. Hata bildirimi veya özellik isteği için lütfen ulaşın!

Platform	Link / Contact
🐛 GitHub Issues	Report a Bug
📸 Instagram	@erenorhun
💼 LinkedIn	Orhun Eren Yalçınkaya
📩 Email	orhunerenyalcinkaya@gmail.com

---

✏️ Credits

• DND 5E SRD API
• Open5E
• Sorcery icons created by David Carapinha - Flaticon