TwitchPlayground
A fake Twitch for building OBS plugins without going live.
The problem
Developing an OBS plugin that reacts to Twitch events normally takes a live channel, an audience,
and the patience to wait for something to happen. Testing an edge case — a raid during an ad break,
a burst of channel.follow, a Helix error — comes down to luck.
What TwitchPlayground does
It plays the part of Twitch on your own machine: it emits events to your plugin, answers API calls, simulates a chat, and shows everything going in and out as JSON.
- Two-way — you see what Twitch sends and what the plugin sends back.
- Without consequence — event spam, injected errors, ads on a loop: none of it is real.
- Replayable scenarios — record a sequence, save it, play it back.
Fidelity, no adapter
The guiding principle: your plugin connects exactly as it does in production. No glue code, so no
extra source of error. The only injection point is the base URL, driven by configuration:
TWITCH_HELIX_URL and TWITCH_EVENTSUB_URL point at the real Twitch URLs in production, at
localhost in testing.
Same payloads, same EventSub handshake (session_welcome / keepalive / reconnect), same
signatures, same error formats.
Surfaces covered
| Surface | Coverage |
|---|---|
| EventSub | WebSocket handshake, subscriptions, notifications, reconnection, injectable faults |
| Helix | Subscriptions, streams, channels/commercial, ads, error codes |
| Chat | Simulated chat engine |
| RTMP | Local ingest triggering stream.online / stream.offline |