OBS overlay that connects to GoDice Bluetooth dice and displays rolls on stream in real time. I built it for my online TTRPG sessions so physical dice rolls show up directly in the camera feed.
What it does
- Connects to one or more GoDice over BLE, shows each roll as an animated overlay in OBS
- Supports all die types: D4, D6, D8, D10, D10X, D12, D20
- Auto-reconnects on disconnect
- Detects fake rolls (placed, not thrown) and suspicious ones (nudged), with configurable handling
- LED feedback: die color, white, or crit mode (green on max, red on min)
- Roll history in SQLite with CSV export
Stack
Python 3.14, NiceGUI for the web UI, GoDice Python SDK for BLE communication, aiosqlite for roll storage. Managed with uv.
uvx godice-overlay