Docs
Everything you need on the first day, in the order you'll need it.
Set up in five minutes
- Output. Audio → pick where narration should play. For stream only: your speakers or a dedicated virtual cable captured by OBS. For Discord too: a virtual cable set as your Discord mic alongside your real mic (VoiceMeeter mixes them).
- Persona and game. Session → choose a commentator and a preset. The Naturalist and Booth are free.
- Triggers. Each preset has default hotkeys per moment; remap them on the Triggers page. The defaults work while the game has focus.
- Mic (optional). Turn on mic callouts and say a moment — "got him", "clutch", "that was lag". Recognition runs on your PC.
- OBS. Add a Browser Source at
http://127.0.0.1:3847/overlay. Under Integrations, connect obs-websocket to duck game audio while the persona speaks.
Stream Deck
Install the plugin from the release page. Four actions: Trigger a moment, Say a custom line, Mute for a while, and Switch persona or preset. Paste the API token from Triggers into the plugin's global settings once.
Stingers
Repeated moments (kill, death, victory) are pre-rendered per persona, voice and game, saved on your PC, and never rendered again — switching games all night costs nothing. Settings → Stinger library shows each cached set and lets you delete it.
Local API
GET http://127.0.0.1:3847/trigger?event=kill&token=… fires a moment; POST /transcript sends a callout; /mute, /unmute, /status, /events (SSE) and /overlay round it out. State-changing calls need the bearer token shown on the Triggers page. Streamer.bot, Lioranboard and shell scripts all work.
Privacy, plainly
Mic audio is transcribed on your PC unless you switch to cloud recognition. Hosted plans send the moment name and a few words of context to our relay to write and speak the line; we keep counts, not transcripts. Studio sends nothing to us at all — your keys talk to the providers directly.
Troubleshooting
- Hotkey does nothing in game. Check Triggers shows the helper as running; a stale helper from a crashed session is cleaned up on launch. Some anti-cheat titles block all injected input — mic callouts and Stream Deck still work.
- No audio. Confirm the output device on Audio, then use Test. If OBS captures it but you can't hear it, that's expected for a virtual cable — monitor it in OBS.
- "Unknown event" from a third-party tool. The moment isn't in the current preset; it still narrates as a generic flagged moment. Add it to the preset or map it in Triggers.