Chat Wheel — TikTok Live Vote & Wheel overlay
Chat Wheel is a neon prize machine: viewers type the keyword to spin, results land on the WINNER panel, and history exports to CSV. Transparent giveaways, open to everyone.
Prerequisite: install and run TKStudio (Windows desktop) and connect it to the TikTok LIVE room you are streaming. This article stands on its own — from configuration to OBS / TikTok LIVE Studio setup.
When to use it
Follower milestones, hourly giveaways, celebration drops — the spin itself is public theater, far more trustworthy than a private draw. The WINNER panel keeps history and Export dumps a CSV so fulfilling prizes never relies on screenshots.
Craft the keyword around your channel name so every entry also floods chat with your branding.
The demo video above shows Chat Wheel in action (both EN and ZH versions), and the cover previews the layout; the plugin page's live preview is the source of truth.
Configuration
Configure everything on the plugin page in TKStudio — tune on the left, preview live on the right, then hit Generate link. The table below lists every parameter in panel order, its default, and practical gotchas.
| Parameter | Description | Default | Gotchas |
|---|---|---|---|
title | Heading text on top of the overlay. | Chat Wheel | Leave empty to hide the heading row entirely. |
chatKey | Chat keyword that spins the wheel. | SPIN | Case-insensitive is friendlier; pin the keyword in your title or top chat. |
spinSec | Total wheel spin duration. (2–8, step 0.5) | 4 | Longer builds suspense; past ~6s viewers lose interest. |
holdSec | Hold time for a result or message. (1–8, step 0.5) | 3 | Wheels need ≥3s so winners can screenshot the result. |
fontSize | Font size in pixels. (14–40) | 26 | Works together with Scale: set font size first, then scale the whole overlay. |
size | Overall overlay scale (1–10). (1–10) | 5 | You can still resize in OBS / LIVE Studio afterwards; avoid stacking both too small. |
prizes | Wheel prize slices. | — | 6–12 slices: fewer is dull, more makes labels tiny. |
How to use it in OBS
This section assumes you have generated and copied the link: open TKStudio → pick Chat Wheel → choose the room and tune parameters → Generate link → Copy link. Keep TKStudio running while you stream — the overlay link talks to the local TKStudio process.
Add the link to OBS as a Browser Source:
- In the Sources dock click + → Browser.
- Paste the copied link into URL; set width / height to your canvas (usually 1920×1080).
- Leave Shutdown source when not visible unchecked so the overlay never pauses.
- Click OK, then drag / resize the source into position.
Placement: Wheels demand focus — center or upper-center during the draw, shrink to a corner between rounds.
- The page background is transparent out of the box — do not override it with custom CSS.
- After changing parameters, Generate link again and refresh the Browser Source (or update its URL).
- One plugin = one Browser Source; add more sources for more overlays.
How to use it in TikTok LIVE Studio
If you go live with TikTok LIVE Studio, the approach is the same — a browser layer, nearly identical to OBS:
- Open your scene / layer list in TikTok LIVE Studio.
- Add a Browser layer.
- Paste the link from Copy link into the URL field.
- Match the canvas size (e.g. 1920×1080) and keep the background transparent.
- Position the layer, go live, and send a test chat / gift to confirm it animates.
- TKStudio and TikTok LIVE Studio must run on the same PC (the link points to 127.0.0.1).
- Blank overlay? Make sure TKStudio is connected to the right room, then re-copy the link and refresh the layer.
- After regenerating a link, refresh or re-create the browser layer.
Related plugins
Browse all plugin docs or try them live in the TKStudio marketplace.