Wheel of Item

You're signed in — Pro unlocks the full streamer dashboard

Free accounts can browse the setup guide and the test pipeline. The configurable dashboard (wheel picker, donation trigger, voice, VTube Studio) needs Pro tier.

Become a Pro Supporter — $1/mo
FOR STREAMERS & VTUBERS

Let your viewers spin the wheel by donating

Streamlabs tip lands → wheel auto-spins in OBS, donor name read out loud, your VTube Studio model triggers a hotkey. One browser source. No bots, no extensions, no Twitch dev account needed.

Open Streamer Dashboard → See the 4-step setup
Live in ~5 minutes Token stays in your browser 🆓 Free to try, Pro to publish live

One donation. Three reactions, in parallel.

Every tip fires the same event — each subscriber listens and reacts independently. Mix any combination.

FREE to test · PRO live

Auto-spin the wheel

Donor & amount appear as a toast on the OBS overlay, then the wheel spins and lands on a winner. Works on the regular wheel or the gachapon-tier roll.

ongoing

Read the name out loud

Web Speech TTS reads "Thanks DonorName, 5 dollars!" right on stream. Pick voice, rate, pitch — fully customizable template. OBS captures it on your audio output.

ongoing

Trigger your VTuber model

VTube Studio hotkey fires based on rules — e.g. donate $50 → "epic dance", message contains "wave" → "wave hello". Local WebSocket, no cloud middle-man.

4-step setup

Total time: about 5 minutes. You'll need a saved wheel template and a Streamlabs account.

1

Open the streamer dashboard

Head to streamer.wheelofitem.com/dashboard and sign in with the same Google account you use on wheelofitem.com.

Pro tier required to actually go live. Free accounts can test everything in Manual mode but the Streamlabs adapter won't fire until you're a Pro supporter. Upgrade for $1/mo →
2

Pick a saved wheel or gachapon

Don't have one yet? Go build a wheel on the main page or set up a gachapon, then click Save as new. It'll show up in section 2 of the dashboard.

You can save multiple templates — different prizes per stream, different language wheels, etc. — and swap which one is "live" from the dashboard.

3

Connect Streamlabs (or test with Manual mode first)

In section 4 of the dashboard, pick the donation source:

  • Manual (test only) — fire fake donations from the dashboard. Use this first to confirm everything is wired right.
  • Streamlabs — listen to real tips in real time. Paste your Streamlabs socket token (get it at streamlabs.com/dashboard#/settings/api-settings → "Show socket token").
Streamer dashboard donation panel with Streamlabs configured
Token security: your Streamlabs token lives only in your browser's localStorage. It is never uploaded to wheelofitem.com servers — the widget connects directly to Streamlabs from your machine.
Use the Socket Token (read-only, listens to events), not the Access Token / OAuth client ID. Different thing.
⏱ Delay before spin (optional): right under the source picker there's a "Delay before spin (seconds)" field. Set it to 0 (default) for instant spin, or 10–15 if you want Streamlabs' normal donation alert (image + sound + donor name) to play first and the gachapon to take over after that. Max 60s.
4

Add the widget URL to OBS

In section 5 of the dashboard, hit Copy on the Browser Source URL. Then in OBS:

  • Sources → + → Browser Source
  • URL: paste the URL from the dashboard
  • Width: 520 · Height: 520 (or whatever fits your layout)
  • Click OK — the wheel should render transparent over your scene
Donation toast and spinning wheel as seen on the OBS overlay
Smoke test: use a $1 alt-account tip to yourself. Within 1-2 seconds you should see the toast pop and the wheel spin. If nothing happens, see Troubleshooting below.

Pro Supporter unlocks live donation triggers

The donation pipeline is a Pro perk. Free accounts can wire and test everything — Pro flips the switch from "test only" to "live on stream".

Real-time Streamlabs trigger
Text-to-Speech donor announcements
VTube Studio hotkey rules
Unlimited saved templates
Cloud-synced pull history
No ads across the whole site
Become a Pro Supporter — $1/mo

Troubleshooting & FAQ

The short answer to the most common "why isn't this working?" questions.

Donation came in but the wheel didn't spin
Walk through this list:
  1. Check the URL in OBS — it must contain ?donation=streamlabs&sl_token=…. If not, regenerate it in dashboard section 5.
  2. Open the URL in a regular browser with &status=1 appended. The status pill in the top-right should read streamlabs connected (green). Red means a bad token — get a fresh socket token.
  3. If you set &min_amount=5, donations under $5 are filtered out on purpose.
  4. If a previous spin is still animating (~9 sec), the next donation is skipped intentionally to avoid mid-spin chaos. Queue mode is on the Phase 4 roadmap.
Does this work with Streamlabs Desktop instead of OBS?
Yes. Streamlabs Desktop is OBS-based — paste the widget URL into a Browser Source the same way.
Is my Streamlabs token uploaded to your server?
No. The token sits only in your browser's localStorage. It never leaves your machine for wheelofitem.com servers — the widget connects directly to the Streamlabs socket from your OBS browser source. The trade-off: the token is visible in the widget URL you paste into OBS, so don't share that URL or screenshot it.
Does Ko-fi or StreamElements work?
Not yet. Streamlabs is supported now (Phase 1). Ko-fi requires a webhook receiver (Cloudflare Worker) and is on the Phase 4 roadmap. StreamElements RTM adapter is also Phase 4. Tell us which you need and we'll prioritize.
Can I trigger the wheel from Twitch chat instead of donations?
Yes — that's a separate feature already shipped. The streamer dashboard has a "Viewer-triggered spins" section that listens to !spin commands in your Twitch chat (mod-controlled by default). Both can run side-by-side.
What if I change my mind — can I cancel Pro?
Anytime. Pro is a Patreon "Coffee Supporter" tier — cancel from your Patreon account and you'll keep the perks until the end of the current billing month. The streamer dashboard reverts to test-only mode after that, your saved templates stay safe.

Try our premium voices — for free

Pick any of 41 neural voices (incl. 6 Multilingual that speak Thai). Sign in once → unlimited free previews (30/hr limit).

Like what you hear? Upgrade to Pro ($1/mo) to use it on real donations + get 1,000 voice readouts per month.

Ready? Let viewers spin your wheel.

Sign in once, paste your Streamlabs socket token, drop the URL into OBS. Done.

Open Streamer Dashboard →
Or build a gachapon first →

Streamer Dashboard

Pick a wheel, set up your widget URL, connect Twitch chat. Changes propagate to your stream in seconds.

Choose a wheel or gachapon saved

Wheels saved on wheelofitem.com. Click one to use it as your stream widget.

Loading…

💡 How the Live toggle works: Click 🟢 Live on a card to let real donations trigger that template — or ⚪ Off to ignore them. Turn Off templates that aren't in your current OBS scene so they don't spin silently in the background and pollute your pull history. New saves default to Off — toggle them on before going live. (Manual "Fire test donation" below always works either way.)

Donation trigger PRO

Spin the wheel automatically when someone donates. Streamlabs only for now — Ko-fi and StreamElements coming later.

Your settings auto-save as you type. The button above forces an immediate save.

Fire a test donation

Fires a fake donation into the preview frame below — wheel should spin (and voice will read if enabled below).

🔗 Open Streamlabs Test page →

Want to test Streamlabs's FULL pipeline (alert sound + their event format)? Open Streamlabs in a new tab — click their Test button there → the event reaches your widget here through the socket you already connected. Keep the tab open so you don't have to log in again next time.

Voice (TTS) Beta test

Read the donor's name + amount + message aloud on stream. Captured by OBS through your browser source's audio.

Placeholders: {donor} {amount} {currency} {message} {source}

Premium voice (41 voices · 6 Multilingual in every language)

Multilingual voices (Ava / Andrew / Emma / Brian / Masaru / Hyunsu) appear under every language group — they speak Thai / English / Spanish / Japanese / Korean / Chinese natively with expressive prosody. Plus native-accent voices per language. Free users: 20 donations/month. Pro: 1,000/month.

This month's usage —

Resets at the start of each month

Uses the Template text above (with placeholders filled from the test donor / amount / message in section ). Doesn't count toward your monthly quota.

Your widget token lives in our database, never in the URL of a public page. If you share your widget URL publicly, click to rotate the token and invalidate the old one.

VTube Studio PRO ongoing

Make your VTuber model react to donations — fire a hotkey by amount or keyword. Work in progress — UI hidden while we finish testing the WebSocket integration. Coming back soon.


        

      

    


    
    

      
 Twitch — chat commands + channel points — optional

      
Only fill this in if you stream on Twitch and want viewers to !spin from chat or spend Channel Points / Bits. Skip it for a donation-only setup.

      
      
      
Lowercase username (no #, no URL). Used to read chat commands.


      
      

        
        
      


      

        Who can use chat commands?
        

          

          
          
!spin and !remove are always mod-only. Broadcaster + mods can always use everything.

        

      


      

        Display options
        

          

          

          

          
          
        

      


      
      

         Channel Points + Bits (Twitch) PRO
        
Viewers spend Channel Points to !spin — the widget detects the Twitch custom-reward-id and authorizes the spin even from non-mods.

        

          

             These triggers are part of our Pro tier ($1/mo).
            Upgrade to Pro →
            

You can preview the setup below; spins from Channel Points / Bits will activate once your account is Pro.
          

          

            Channel Points — any viewer can !spin when a Twitch Channel Points reward
            is configured to send !spin to chat. The widget detects the custom-reward-id tag
            and authorizes them. Setup guide →
          

          
          
          
When a viewer cheers Cheer100 !spin with this many bits or more, the wheel spins. Bits stay on the channel — you keep them.

        

      


      
    


    
    

      
 Copy your URLs + live preview

      
Paste these into OBS / Streamlabs Browser Source. Widget endpoint stays on streamer.wheelofitem.com for bandwidth isolation.


      
      

        

          
          

            Persist all your config on refresh
            Saves: wheel pick, donation source + delay, voice (free + premium), Twitch settings, popup mode, etc. — to both your cloud account and this browser.
          

        

      


      
      

        
        
      


      
      
⏳ Coming after the Wheel of Item Twitch Extension is approved by Twitch.


      

        
        Select a wheel above to start
      


      
Live preview

      
What your viewers will see — refreshes every time the URL changes.


      
      

        💡 Preview blank?
        That's normal when popup mode is on and Donation source = Streamlabs — the widget stays hidden until a real donation triggers it.
        Test it by firing a tip from
        Streamlabs → Alert Box → Test → Streamlabs → Tipping
        (📷 see example).
        That hits the same socket your widget is listening to.
      


      

        

        
Pick a wheel or gachapon in section 

        
The live preview will appear here once you select what to spin. Then fire a test donation in section  to see it in action.