Super Awesome Name Spinner (SANS) for Live Streaming
This Streamer.bot extension allows streamers to spin to select a user, or items from a list at random. REQUIRES 4+ Entries for proper animation. All controls can be manage via command or deck button and the spinner itself can be customized to fit nearly all stylings. Inspiration/styling came from this OG Codepen
How-To Incorporate the Super Awesome Name Spinner (SANS) Live Stream Video Tutorial
<< VIDEO COMING SOON >>
Download from Ko-fi
You MUST have the WebSocket server enabled in Streamer.bot for this extension to work.
To enable the WebSocket Server, click on Servers/Clients, then WebSocket Server and ensure Auto Start WebSocket Server is checked (and if not already started, press Start Server).

Setting up the Super Awesome Name Spinner (SANS) in Streamer.bot
In Streamer.bot click the Import button in the top menu. Drag the downloaded .sb file into the Import String field and click Import. You will see 7 Actions, 1 Queue and 3 Commands
Once the extension is imported, navigate to the Commands tab, and scroll down to 'Mustached_Maniac Super Awesome Name Spinner' and Right-Click on each of the 3 Commands and then press Enable

Available Actions for the Super Awesome Name Spinner (SANS) Extension
- Adding Users to the Spinner
- Users can be added to the spinner by using the
!addcommand followed by the user's name. - Broadcaster can manually add users by enabling the
%user%variable in theAdd User to Spinneraction and then using the command, or a Streamdeck button.
- Users can be added to the spinner by using the
- Add items to the wheel via a list
- Requires a valid file path in the
%spinList%argument (can be used for quick adding things like game names, perks within a game, etc.) - Each name should be on a new line
- Requires a valid file path in the
- Clear the Wheel
- The
!clearcommand will remove all users from the spinner
- The
- Remove Name from Wheel
- The
!removecommand will remove that user that triggered it from the spinner - Broadcaster can manually remove users by enabling the
%user%variable in theRemove User from Spinneraction and then using the command, or a Streamdeck button.
- The
- Shuffle the Wheel
- Currently no command associated, I use a Streamdeck button to shuffle the wheel (could use a hotkey or Command)
- Spin Complete - Announce Winner
- There is NO Trigger associated with this action, it is meant to automagically announce the winner once the wheel has stopped spinning
- Spin the Wheel
- Currently no command associated, I use a Streamdeck button to spin the wheel (could use a hotkey or Command)
If you typically have less then 4 users, you can add a slight delay and then duplicate the 'Add Name' method to add the same user multiple times in the same action.
Adding the Super Awesome Name Spinner to OBS Studio
You can use SANS straight out of the box and it will work just fine.
Navigate to the
ScenesTab and press+to create a newScene(you can name it whatever you'd like)

On your new
Scene, Click on theSourcesTab and press the+to create a newBrowser Source(name is irrelevant again)

Double-Click on your newly created
Browser Sourceand edit the URL to the one provided
https://mustachedmaniac.com/widgets/Spinning_Names
Congrats, you're ready to start using the Super Awesome Name Spinner (SANS)!!
If you'd like to further customize it, use the tool below to tweak things like spin duration, color options, alignment, etc.
When using the tool below, toggle a paramter to the On position, and then press the Update URL button to see a live preview. You can then copy the newly generated URL into your browser source to have the changes reflect on your version.
Customizing SANS to Match your Asthetic
There are several URL parameters that can be added to the end of the link above to customize SANS to your liking.
Special Note-The container has a white background and the font is white by default, to visibly see you changes, enable the 'Font Color' Option and select anything other then white
Live Preview
| Parameter | Example | Description |
|---|---|---|
| host | 192.168.1.1 | Only needed if your Streamer.bot websocket address is NOT on 127.0.0.1 |
| port | 8118 | Only needed if your Streamer.bot websocket port is NOT on 8080 |
| endpoint | "/stuff" | Only needed if your Streamer.bot websocket endpoint is NOT on "/" |
| password | "mYsEcReTp@$$w0rd" | Only needed if you have authentication enabled on your Streamer.bot websocket |
| duration | 30 | Adjust the length of the spin. Can be 5-60 seconds (default is 10) |
| align | left | Set the text to be aligned to the left / center / right of the box (default to center) |
| font | Roboto | Accepts system and Google fonts |
| color | red | Pick a different text color. Accepts names or hex values (defaults to white) |
| bg | #000000 | Pick a different background color. Accepts names or hex values (defaults to no background/transparent) |
| max | 10 | Set the maximum number of entries per user (default is 1) |
