StreamJuice Giveaways is a free, interactive prize wheel built for Twitch streamers. Viewers can enter from chat, you can spin the wheel live, and the process can be shown on stream through an OBS browser overlay.
Try a different keyword like overlay, commands, subscriber, attract mode, raffle bowl, elimination, or Twitch.
Getting Started
Basics for using the wheel manually or with a StreamJuice Giveaways account.
Yes. The core StreamJuice Giveaways features are free to use. Donations help support server costs and future development, but they are never required to use the giveaways tool.
No. The main wheel can be used without an account by typing or pasting entries manually.
You only need an account if you want saved settings, Twitch chat integration, OBS overlays, and dashboard customization.
Sometimes older authentication tokens stop behaving correctly after backend improvements. Relinking Twitch refreshes your connection and helps keep chat integration stable.
Go to your dashboard, disconnect Twitch, then link it again.
Wheel Features
Core wheel behavior, multiple giveaway lists, weighted entries, shuffle behavior, claim windows, and elimination mode.
Use the special entry format:
AwesomeViewer !5
That adds the same viewer five times. This works on the main page and in saved wheel entries.
Logged-in users can run up to three separate giveaway lists. Each list keeps its own name, giveaway key, entries, claim time, and wheel design settings.
That means you can keep different giveaways ready at the same time instead of rebuilding the wheel from scratch every time.
For example, you could have one list for a follower goal giveaway, one list for subscribers, and one list for a special event. Switching tabs changes which giveaway you are editing and controlling.
Your default giveaway is the one StreamJuice uses when no specific giveaway key is provided.
If your overlay link does not include a giveaway key, the overlay will show your default giveaway. If chat commands are used without a giveaway key, they will also apply to your default giveaway.
This makes it easy to keep one main giveaway live while still having other giveaway lists saved and ready.
No. The wheel layout is randomized so the wedge order stays unpredictable and fair.
Elimination Mode repeatedly spins and removes one entrant at a time until only one winner remains.
It uses your current spin duration and announce delay for each round.
From chat, moderators can start it with !spinwheel elimination or !startwheel elim.
Yes. The main wheel has a mute button you can toggle at any time. Your preference is saved in your browser for future visits.
Twitch & Chat Commands
How chat integration works and what the main commands do.
When you link your Twitch account, StreamJuice Giveaways can send messages in your channel on your behalf. Once the wheel is started, viewers can use your join command in chat to enter automatically.
Command names can be customized in your dashboard, but the defaults are:
!startwheelstarts a giveaway using your saved settings.!stopwheelstops new entries.!spinwheelspins the wheel normally.!spinwheel eliminationstarts elimination mode.!resetwheelclears the current giveaway.!shuffleshuffles entries in the current giveaway.!add @Viewer x5manually adds entries.
Viewers normally enter with your join command, such as !join or whatever custom command you set.
If you use multiple giveaway lists, you can also target a specific giveaway by adding its giveaway key after the command. For example:
!join 1k!startwheel 1k!spinwheel 1k
If no giveaway key is included, StreamJuice uses your default giveaway automatically.
A giveaway key is a short single-word identifier for one specific giveaway list.
It lets you target the correct giveaway from chat. For example, if your giveaway key is 1k, viewers can enter that giveaway with !join 1k.
Keys are especially useful when you have more than one giveaway saved, because they let you control or enter the exact giveaway you want instead of always using the default one.
Each giveaway list can have its own claim time. When a winner is chosen, StreamJuice can prompt them in chat and give them a set number of minutes to claim their prize.
The claim message can include the giveaway name and key, which helps viewers know exactly which giveaway they won if you are running more than one list.
If the winner does not claim in time, the claim window expires and you can decide what to do next on your stream.
The Subscriber Bonus lets you award extra entries whenever a subscriber joins. For example, if you set the bonus to 3, subscribers get three entries per join while non-subscribers get one.
This does not change the join limit. It only changes how many entries are added per successful join.
Viewers use the join command while the wheel is active. Administrative commands like start, stop, spin, reset, and add are limited to the broadcaster and channel moderators.
Overlay & OBS
Setup instructions, overlay behavior, and layout control.
Copy your unique overlay URL from the dashboard and add it to OBS as a Browser Source. A 1920x1080 browser source is a good starting point for full-scene overlays.
Your overlay now uses your overlay pin in the URL, like this:
https://giveaways.streamjuice.xyz/overlay.php?pin=YOUR_OVERLAY_PIN
If you leave out a giveaway key, the overlay follows your current default giveaway automatically.
The recommended background size is 1024x1024. Use the template below to keep important art clear of the wedge area.
You can customize the overlay using URL parameters.
&wheel=500sets the wheel size in pixels&x=-600moves the overlay left or right&y=-200moves the overlay up or down&attract=1keeps the wheel visible&alerts=0disables alerts&alertonly=1shows alerts only
Example:
https://giveaways.streamjuice.xyz/overlay.php?pin=YOUR_OVERLAY_PIN&wheel=500&x=-600&y=-200&attract=1&alerts=0
If you want the overlay locked to one specific giveaway instead of following your default giveaway, add that giveaway’s key too:
https://giveaways.streamjuice.xyz/overlay.php?pin=YOUR_OVERLAY_PIN&key=1k&wheel=500&x=-600&y=-200&attract=1
Raffle Bowl
Alternate visualizer mode and its animation styles.
The Raffle Bowl is an alternate visualizer where entries become balls inside a floating bowl. When a winner is chosen, the winning ball rises while the others fall back.
You can switch between the Wheel and Raffle Bowl from the dashboard and choose between animation styles like Popcorn, Tornado, and UFO Tractor Beam.
Custom Sounds
Upload or link custom spin audio.
You can upload a custom sound under 3MB or paste a direct sound URL. Supported formats include .mp3, .wav, and .ogg.
When a custom sound is set, it overrides the normal tick sound selection and loops during the spin before fading out near the winner announcement.
Troubleshooting
Fixes for the most common issues.
__bonus__ is an internal tag used for bonus entries. If it appears visually, refresh your overlay and let the bot resend the cleaned entries list.
If chat messages stop posting or the connection seems stuck, your Twitch token may have expired. Disconnect Twitch in the dashboard and link it again to refresh the connection.
This is usually caused by an old ghost connection. Disconnect Twitch and relink it to force a fresh single connection.
OBS sometimes caches browser sources aggressively. Open the Browser Source properties and use the refresh cache option for the current page.
If a command or overlay does not include a giveaway key, StreamJuice uses your default giveaway.
If you expected a different list, either set the correct giveaway as default or include the specific giveaway key in the command or overlay URL.
For example, use !join 1k in chat or add &key=1k to your overlay link if you want to target that specific giveaway.
Account, Security & Legal
Privacy, account control, and giveaway responsibility.
Yes. StreamJuice Giveaways only requests the permissions needed to operate the service, and you can disconnect Twitch or delete your account from the dashboard at any time.
Yes. Giveaway and sweepstakes laws vary by region and platform. It is your responsibility to make sure your giveaway setup follows applicable local laws and platform rules.
Review the Terms of Service for more information.
The best place for help, updates, and community feedback is the official Discord server.
Video Tutorials
Watch setup and walkthrough videos for StreamJuice Giveaways.
BeardedInk Setup & Walkthrough
BeardedInk put together a full walkthrough for StreamJuice Giveaways, covering setup and usage in OBS. Big thanks to him for letting us feature it here.