OBS Streamer Mode: Transparent Wheel & 3D Dice Overlays
Turn any SpinWheelGames random picker, giveaway winner wheel, or polyhedral RPG dice roller into a clean, chroma-free transparent browser source overlay in OBS Studio and Streamlabs by adding ?stream=1 to the URL.
What Is Streamer Mode (?stream=1)?
Standard web pages include navigation bars, footers, educational guides, and opaque backgrounds that clutter a live broadcast if captured directly. When you append ?stream=1 to any tool on SpinWheelGames.org, the engine switches into a dedicated broadcast overlay architecture:
Hides the header, navbar, footer, dice navigation hub, FAQs, and SEO text before the first frame renders. Only the wheel or dice stage and winner banner appear over a 100% transparent background.
Trigger spins and dice rolls via keyboard hotkeys (Space, R, N), the paired /stream-control browser tab, or Twitch/YouTube chat bot webhooks.
Caps active spin and 3D physics rendering at 30 FPS by default (60 FPS optional), limits devicePixelRatio, and pauses rendering completely (0% CPU) whenever the wheel or dice are idle.
4-Step OBS Studio Setup Instructions
Add Browser Source
In OBS Studio, go to the Sources dock, click the + button, choose Browser, and name your source (e.g., Giveaway Wheel Overlay).
Paste Streamer URL
Click the Streamer mode / OBS button on any SpinWheelGames tool, copy the generated ?stream=1&id=... URL, and paste it into the OBS URL field.
Set Size & OBS Audio
Set Width to 1920 and Height to 1080 (or 900×900 for corner widgets). Check Control audio via OBS to manage sound in your OBS Audio Mixer.
Spin via Remote or Key
Open /stream-control in your normal browser to trigger spins and edit names live, or right-click the source in OBS and select Interact.
?stream=1 URL, and enable Control Audio via Streamlabs Desktop. If your streaming PC is running a GPU-intensive game alongside a 3D tabletop stream, append ?stream=1&quality=low on dice pages to switch to the ultra-lightweight 2D vector dice renderer.Keyboard & OBS Interact Hotkeys
When the overlay window or OBS Interact dialog has focus, these single-key shortcuts operate the wheel and dice rollers immediately:
- Spin Wheel / Roll DiceSpace / Enter
- Remove Last Winner (No Repeats)N
- Reset Entries & Clear BannerR
- Mute / Unmute Overlay AudioM
Real-Time Remote Control (/stream-control)
Because OBS Studio runs Browser Sources inside an isolated Chromium Embedded Framework (CEF) process, keyboard presses while you are playing a full-screen game will not reach the browser source unless you open OBS Interact.
Our companion Remote Control Deck (/stream-control?id=<session>) solves this completely: open it on a second monitor, tablet, or smartphone to trigger spins, eliminate winners, and push updated participant lists to your OBS overlay in real time. Session IDs are cryptographically random and require zero login or personal data.
Supported Streamer Mode URL Parameters
Combine any of these query parameters on wheel or dice URLs to customize your OBS overlay behavior:
| Parameter | Allowed Values | Default | Behavior & Purpose |
|---|---|---|---|
| ?stream=1 | 1 | Off | Activates Streamer Mode: hides all page chrome (header, nav, footer, SEO text, FAQs) and sets html/body background to 100% transparent alpha. |
| ?id=<session> | Alphanumeric token | Auto-generated | Pairs the OBS Browser Source with the live /stream-control?id=<session> remote control deck for cross-tab and cross-device triggers. |
| ?entries=A,B,C | Comma or | list | Tool default | Preloads up to 200 custom wheel entries (max 80 characters per label, strictly sanitized against HTML/XSS) directly from the URL. |
| ?size=sm|md|lg | sm, md, lg | md | Scales the wheel or dice canvas and result typography for corner webcam overlays (sm), standard scenes (md), or full-screen 1080p reveals (lg). |
| ?theme=light|dark | light, dark | dark | Switches the winner banner, history card, and dice badges between high-contrast Dark Neon and Light Crisp themes. |
| ?labels=outline | outline, normal | outline | Adds a high-contrast black stroke outline and drop shadow around slice labels and result text so every label reads cleanly over bright gameplay. |
| ?sound=0|1 | 0, 1 | 1 (Moderate) | Controls Web Audio tick and fanfare synthesis routed through the OBS Browser Source audio mixer. Set ?sound=0 for silent overlays. |
| ?removewinner=1 | 0, 1 | 0 | Automatically eliminates each winning slice after a spin completes so giveaway and raffle draws never repeat a previous winner. |
| ?winnerseconds=5 | 0–60 (seconds) | 5 | Number of seconds the large winner or dice total banner stays visible before auto-clearing. Set ?winnerseconds=0 to keep until manually reset. |
| ?history=1 | 0, 1 | 0 | Displays a compact on-screen history card in the top-left corner listing the most recent winners or dice roll totals. |
| ?autospin=1 | 0, 1 | 0 | Automatically triggers one wheel spin or dice roll 450ms after the browser source loads—ideal for OBS scene-switch stingers and automated alerts. |
| ?quality=low | high, low | high (3D) | For dice tools (/dice/d20, /dice/d6, /roll-4d6): switches from the 3D WebGL physics engine to a lightweight 2D vector dice mode for ultra-low CPU usage. |
| ?fps=30|60 | 30, 60 | 30 | Caps the active animation loop frame rate during spins and dice rolls (30 FPS default to protect game encoding). Pauses completely at 0 FPS when idle. |
Troubleshooting OBS & Streamlabs Overlays
1. Black or Opaque Background
Verify that ?stream=1 is included in the Browser Source URL and that you have not applied a Color Key filter or custom background fill in OBS. On dice pages, Streamer Mode automatically replaces the wooden dice tray with a transparent shadow-catcher plane.
2. No Sound in Stream Audio
Ensure Control audio via OBS is checked in the Browser Source properties and that the URL does not contain ?sound=0. In OBS Advanced Audio Properties, set Audio Monitoring to Monitor and Output so both you and your viewers hear the wheel ticks.
3. Hotkey Not Working Mid-Game
OBS Browser Sources ignore global OS keystrokes when unfocused. Keep /stream-control?id=<session> open on your phone or second monitor—tapping SPIN / ROLL OVERLAY triggers the OBS browser source over the network in real time.
Launch Stream-Ready Wheel & Dice Tools
Comment & Giveaway Winner Picker
Fair raffle & social giveaway draw wheel with Web Crypto RNG and auto-remove winner.
Wheel of Names Random Picker
Classic customizable name spinner for viewer subathons, marbles, and squad picks.
3D d20 Icosahedron Dice Roller
Roll a 20-sided tabletop RPG die over a transparent alpha shadow-catcher stage.
3D d6 Standard Cube Dice Roller
Roll 6-sided board game dice in 3D WebGL or lightweight 2D vector streamer mode.
Roll 4d6 Drop Lowest Stat Roller
Live D&D 5e character creation stat roller showing kept dice, dropped lowest die, and sum.
Food & Game Decision Wheels
Let your chat or squad decide what game to play or what food to order on stream.
Streamer Mode & OBS Overlay FAQs
Everything you need to know about entropy, provable fairness, custom odds, and embeds.