Skip to content

DM Whisper 0.1.0

Choose a tag to compare

@github-actions github-actions released this 22 Jun 20:39
· 205 commits to master since this release
5444090

DM Whisper 0.1.0 — first installable release

AI-assisted D&D 5e session management for Roll20 + D&D Beyond. This is the first packaged build: a one-click installer that runs the whole stack — no terminal, no Python, no Node, no Claude Code required. Speak to your table; the assistant tracks combat, rolls, conditions, and maps in Roll20 while you DM.

Heads-up: these builds are unsigned, so Windows SmartScreen and macOS Gatekeeper will warn on first launch (Win: More info → Run anyway; Mac: right-click → Open). Signing + notarization is the next release.


What's in the box

🔮 DM Whisper — the voice HUD. A transparent "scrying-gem" overlay that sits on top of Roll20. Push-to-talk → on-device speech-to-text → a Claude agent that drives your game. Includes a first-run setup familiar (API key + one-click Roll20 / D&D Beyond sign-in), a player inbox, a live combat HUD, and a training/after-action loop that learns your table's vocabulary.

⚔️ Live combat engine. HP, conditions, and initiative tracking; dice rolled through Roll20's own public roller (visible to players); turn hooks; area-of-effect resolution in a single call; and a tactical AI that scales monster cunning to its Int/Wis. PC HP is tracked separately so Beyond20 stays the source of truth for player sheets.

🗺️ Map prep suite. Battlemap upload, Claude-Vision wall detection, automatic dynamic-lighting walls/doors/windows, token creation, and spell zones — image in, playable lit map out.

📖 D&D Beyond integration (read-only). Pulls characters and monsters straight from your DDB account, including a monster mapper that normalizes the raw stat blocks into usable 5e data.


Under the hood

  • Browserless by default. Talks to Roll20 over its Firebase realtime database and to D&D Beyond via a short-lived token — no headless browser needed at runtime (Playwright remains an optional fallback).
  • On-device STT. Bundles a CPU whisper.cpp build with the base.en model as an offline floor; the familiar can download a larger/GPU model per your hardware.
  • Deterministic transcript correction. A post-STT layer (notation + literal + fuzzy/phonetic) fixes common D&D mishears without an LLM round-trip.
  • The assistant reports; you narrate. Numbers (HP/damage) stay in the DM-facing report; player-visible narration never leaks them.

Downloads

Platform File
Windows DM-Whisper-0.1.0-Setup.exe
macOS (Apple Silicon) DM-Whisper-0.1.0-arm64.dmg
Linux DM-Whisper-0.1.0-x86_64.AppImage

You'll need: an Anthropic API key, a Roll20 campaign with the assistant's Mod script deployed, and (optional) a D&D Beyond account for character/monster data. The setup familiar walks you through the sign-ins.

Known limitations

  • Unsigned builds (Gatekeeper/SmartScreen warnings).
  • macOS ships Apple Silicon only (no Intel build yet); Windows/Linux are x64.
  • base.en is the bundled STT model; larger/GPU models are familiar-downloaded on first run.

🤖 Built and released via the project's CI/CD pipeline (.github/workflows/release.yml).