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.
A viewer tips — your wheel spins and your avatar reacts
A tip on Streamlabs, StreamElements, Ko-fi, SociaBuzz, TikTok or YouTube spins the wheel live in OBS, reads the donor out loud, and fires the VTube Studio hotkey you mapped to that exact prize. One browser source. No bots, no extensions, no Twitch dev account needed.
Want to see it before signing up? Paste this into an OBS Browser Source right now —
it's a live demo wheel, nothing to install:
https://streamer.wheelofitem.com/widget.html?id=72bwec
Real capture of the OBS browser source — tip arrives, wheel spins, result lands.
One donation. Three reactions, in parallel.
Every tip fires the same event — each subscriber listens and reacts independently. Mix any combination.
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.
Read the name out loud
Neural TTS voices read "Thanks DonorName, 5 dollars!" right on stream. Pick voice, rate, pitch — fully customizable template. OBS captures it on your audio output.
Trigger your VTuber model
Your VTuber model reacts the moment a donation hits — set one default reaction, or map each wheel prize to its own VTube Studio hotkey so the model reacts differently to every result. Local WebSocket, no cloud middle-man.
More than a donation wheel
Every mode is the same one-line OBS browser source — mix whatever fits your stream.
Gachapon & Tarot, not just a wheel
Swap the wheel for a gachapon capsule machine (tiered rarity + pull animation) or a daily tarot draw — same setup, same triggers.
Channel Points — no donation needed
Let viewers redeem Twitch Channel Points to fire the wheel, gacha or tarot — free triggers so everyone joins in, not just tippers.
Fire it yourself — Live Control
Spin, pull or draw with one click from your dashboard — no donation needed. Great for giveaways and playing with chat.
Popup mode
Keep the widget hidden and let it pop up only when a trigger fires, then auto-hide — no permanent overlay eating your screen.
Discord gacha bot
Bring the gacha to your Discord server too — members pull with a /gacha slash command, capsule reveal animation included.
See the full setup — 2 minutes
Pick what spins, connect your tips, test it, put it on stream — the whole pipeline, for real.
4-step setup
Total time: about 5 minutes. You'll need a saved wheel template and a Streamlabs account.
Open the streamer dashboard
Head to streamer.wheelofitem.com/dashboard and sign in with the same Google account you use on wheelofitem.com.
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.
Connect your donation platform (Streamlabs / Gank)
In section 4 of the dashboard, pick the donation source:
- 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").
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.
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
Troubleshooting & FAQ
The short answer to the most common "why isn't this working?" questions.
Donation came in but the wheel didn't spin
- Check the URL in OBS — it must contain
?donation=streamlabs&sl_token=…. If not, regenerate it in dashboard section 5. - Open the URL in a regular browser with
&status=1appended. The status pill in the top-right should readstreamlabs connected(green). Red means a bad token — get a fresh socket token. - If you set
&min_amount=5, donations under $5 are filtered out on purpose. - 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?
Does Ko-fi or StreamElements work?
Can I trigger the wheel from Twitch chat instead of donations?
!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?
Try our premium voices — for free
Pick any of 41 neural voices (incl. 6 Multilingual that speak Thai). Sign in once → unlimited free previews (200/hr limit).
Like what you hear? Upgrade to Pro ($3/mo) to use it on real donations + get 200 voice readouts per month.
Ready? Let viewers spin your wheel.
Sign in once, paste your Streamlabs socket token, drop the URL into OBS. Done.
Or build a gachapon first → Free stream schedule maker — make your weekly cover → VTuber? See the tip → avatar-reacts loop →Streamer mode needs Pro
Your Discord pack covers the Discord bot and the everyday web features. The streamer dashboard (donation triggers, Live Control, TTS voice and VTube Studio) is part of Pro, so it is not available on this pack.
Streamer Dashboard
How-to guidePick a wheel, set up your widget URL, connect Twitch chat. Changes propagate to your stream in seconds.
Let viewers spin with Twitch Channel Points — no donation needed. Set it up →Discord gacha
Let members of your Discord server pull your gachapon with /gacha. Items and streaks are kept per person, and every pull also shows up in your pull history.
- Add the bot to your server with the button below — you need the Manage Server permission.
- Pick which gachapon it pulls from, how often each member may pull, and who is allowed to.
- Members type /gacha in Discord — that's all they have to do.
You'll be sent to Discord to choose a server. You need the Manage Server permission in it.
When on, members pull only while they have plays. Everyone gets this many free pulls per day; give more with /give play @user N in Discord. Plays and items can never be bought, sold or exchanged for money.
Comma-separated Discord role IDs (turn on Developer Mode, then Server Settings → Roles → right-click a role → Copy Role ID). Leaving this empty while "Only these roles" is selected means nobody can pull.
Right-click the channel → Copy Channel ID (Developer Mode must be on). Empty means /gacha works in every channel.
Co-managers
People you add here can manage this server — edit settings, pick the gacha, unlink — from their OWN Wheel of Item account. Whoever saves the settings last decides which gacha goes live. The owner can never be removed.
Players
Click a member to see everything they have collected.
| Member | Pulls | Best streak | Last pull |
|---|
Discord claw machine
Let members of your Discord server grab your claw machine with /claw. It works in every server you've linked below.
Loading…
Who can pull, the channel limit, and the on/off toggle are server-wide — set them in the Gacha tab.
Loading…
/claw works in every server linked to this account. The Live toggle only affects your OBS overlay.
Discord tarot
Members draw a daily tarot reading with /tarot. It works the moment the bot is in your server — no setup needed.
Leave on Auto so everyone reads in their own language, or force one language for the whole server.

The bot posts the server’s card of the day in this channel at this time (your local time), with a button so members can draw their own. Right-click the channel → Copy Channel ID.
🛠️ Server tarot tools — this server’s colour & name on every tarot card, 3 card styles, and one reading language for everyone — come with the Discord pack or Pro. Every server gets them free for its first 30 days. The reading itself is the same full reading in every server.
Choose a wheel or gachapon saved
Wheels saved on wheelofitem.com. Click one to use it as your stream widget.
Pick this if you only want donation voice (TTS) and/or VTube Studio model reactions — no spinning wheel. The OBS overlay stays fully transparent and just plays the voice + triggers your model. (TTS and VTube Studio are Pro features.)
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.
Donation trigger PRO
Spin the wheel automatically when someone donates — supports Streamlabs, Gank, Ko-fi, StreamElements, YouTube Super Chat, TikFinity and SociaBuzz. Tick whichever sources you use.
Tick every source you use — leave all unticked to turn donation triggers off. Fill in each ticked source's credentials in the boxes below.
Sign in with Google once — we set up your Streamlabs automatically. No API key to hunt for. (You'll finish on your dashboard, then come back here.)
Streamlabs socket token
Find it at streamlabs.com → Settings → API Settings → API Tokens → "Show Socket Token" ( see example).
YouTube Super Chats trigger the wheel automatically through your Streamlabs or StreamElements connection when your YouTube channel is linked there — there's no separate YouTube token to enter.
In Ko-fi → More → API / Webhooks, paste this as your Webhook URL. When someone tips you on Ko-fi, the wheel spins. Then copy the Browser Source URL from section 6 below into OBS (safe to show — no secret in it).
In TikFinity → add a Trigger WebHook action and paste this URL — that's all, there is no body to fill in: TikFinity sends the gift (coins, viewer, gift name) by itself. Link the action to a Gift event and test it with TikFinity's event simulator by sending a gift (running the action by hand carries no coins, so it arrives but never spins). Only older TikFinity versions that still show a JSON body field: use {"coins":%coins%,"count":%repeatCount%,"nickname":"%nickname%","gift":"%giftName%","msgId":"%msgId%"}.
Set your minimum coin threshold in TikFinity's own trigger — a gift only fires the wheel if it passes that threshold. (Secret — don't show this URL on stream.)
The TikFinity action type must be Trigger WebHook — it sends a POST. An action that opens a website or a browser window will not deliver gifts.
With 10 coins: Rose (1 coin) ×10 = 1 play · Doughnut (30 coins) = 3 plays · leftover coins are not counted · empty = 1 gift, 1 play (as before)
⏱️ Several gifts from the same viewer within 10 seconds are added up first, then played as set above · gifts that arrive mid-play wait in line instead of being skipped
- In SociaBuzz open TRIBE → Edit & Settings → Integrations → Webhook.
- Paste this link into Webhook URL and save.
- Press Test Notification there. A green note appears here when the test reaches us. A test never spins the wheel; a real support does.
Copy the Webhook Token from the same SociaBuzz page and save it here: we then accept only calls that carry your token. Leave it empty to rely on the secret link alone.
Paste your Gank Stream URL (Gank → Stream Settings → Stream Alert). We read your Gank tips and spin the wheel / draw a card when one arrives.
Note: unofficial direct link to Gank — may need updating if Gank changes their system.
Find both in StreamElements → Account → Show secrets (Account ID + JWT Token). We connect to StreamElements and spin the wheel / draw a card when a tip arrives. Treat the JWT token like a password — keep it off stream.
Donations below this amount are ignored — no spin, no draw. Applies to every template (wheel, gachapon, tarot). 0 = every donation triggers (default).
💱 Any incoming donation is auto-converted to this currency at daily FX rates before the minimum is checked — so a tip sent in another currency still counts fairly.
Wait N seconds after the donation arrives before the gachapon pops up and spins. Useful when you want Streamlabs' normal donation alert (image + sound + donor name) to finish playing first — then the gachapon takes over.
0 = spin immediately (default). Typical Streamlabs alert is ~7–15 seconds.
Max 60 seconds.
Your settings auto-save as you type. The button above forces an immediate save.
Voice (TTS) PRO
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 — Google Chirp 3 HD (natural multilingual)
Pick a language first, then a voice. Every Google Chirp 3 HD voice is multilingual — it reads ไทย / English / 日本語 / 한국어 / Español / Français / 中文. Premium voice readout is a Pro feature (200 donations/month). If the monthly cap is reached it automatically falls back to the free Google voice, so reads never go silent.
Resets at the start of each month
Uses the Template text above (with placeholders filled from a sample donor name + amount). Doesn't count toward your monthly quota.
Your premium voice is set up automatically — nothing to configure. Your widget token lives in our database, never in the public widget URL.
VTube Studio PRO — optional Watch the setup video (1:43)
Make your VTuber avatar react when someone donates — your model plays an animation (a “hotkey”) automatically. You need the free VTube Studio app running on the same PC as OBS.
- In VTube Studio, switch the API on.
Open Settings (the gear icon) → find “Plugins / Start API” and turn it ON (it uses port 8001). Keep VTube Studio open. - Connect — you only do this once.
Click the button below. A small popup appears inside VTube Studio asking to allow “Wheel of Item” — click Allow. - Pick the animation to play on a donation.
Give your alert or voice a moment first. 0 = react instantly.
Best for a Toggle Expression hotkey — it re-fires the hotkey to turn the face/pose off. Leave 0 for animations (they end on their own). ✨ Cleanest: set “Auto-deactivate after N seconds” on the expression hotkey inside VTube Studio, then leave this 0.
Saved to your account — VTube Studio reconnects automatically each session, on any computer.
- Test it.
-
VTuber reacts to each prize — set an outfit/pose per wheel result (+ timing)Wheel prize → outfit changeEach prize can switch your VTuber’s outfit or pose. Set it up below ↓
Set up the per-prize table
Give each prize its own hotkey — when the wheel lands on it, that animation plays. Only prizes you map here react. Click Load my hotkeys above first.
What each column doesDelay s — how many seconds after the wheel stops before the pose plays (lets your alert/voice land first). 0 = instant.Off s — keep the pose on this many seconds, then turn it off automatically. 0 = stay on (until a new prize in the same group replaces it).Group A/B/C — put poses that can't be worn together in one group (e.g. all outfits = A). Only one per group stays on — winning a new one auto-turns-off the previous one in that group. (Works with Expressions.)Works with a wheel template — pick a wheel in step 2 to use this.PrizeHotkeyDelay sOff sGroup
Copy your URLs + live preview
Paste these into OBS / Streamlabs Browser Source. Widget endpoint stays on streamer.wheelofitem.com for bandwidth isolation.
Live preview
What your viewers will see — refreshes every time the URL changes.
Test your donation alert
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.
Live Control Pro
Fire the widget on your OBS overlay right now — no donation needed. Perfect for lucky draws or playing with chat. The result pops on stream in ~1s (the preview below spins too, silently).
Pick a wheel or gachapon in section
The live preview will appear here once you select what to spin. Then test from your platform below to see it in action.