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).

Enabling the WebSocket Server in Streamer.bot

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 CommandsImporting code for daily check-ins to Streamer.bot

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

Enabling commands for daily check-ins to Streamer.bot

Available Actions for the Super Awesome Name Spinner (SANS) Extension

  1. Adding Users to the Spinner
    • Users can be added to the spinner by using the !add command followed by the user's name.
    • Broadcaster can manually add users by enabling the %user% variable in the Add User to Spinner action and then using the command, or a Streamdeck button.
  2. 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
  3. Clear the Wheel
    • The !clear command will remove all users from the spinner
  4. Remove Name from Wheel
    • The !remove command will remove that user that triggered it from the spinner
    • Broadcaster can manually remove users by enabling the %user% variable in the Remove User from Spinner action and then using the command, or a Streamdeck button.
  5. Shuffle the Wheel
    • Currently no command associated, I use a Streamdeck button to shuffle the wheel (could use a hotkey or Command)
  6. 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
  7. 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.

Creating a new Scene in OBS

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

Creating a new Source in OBS

Double-Click on your newly created Browser Source and edit the URL to the one provided

https://mustachedmaniac.com/widgets/Spinning_Names
Editing a Browser Source in OBS

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

https://www.mustachedmaniac.com/widgets/Spinning_Names

Live Preview


ParameterExampleDescription
host192.168.1.1Only needed if your Streamer.bot websocket address is NOT on 127.0.0.1
port8118Only 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
duration30Adjust the length of the spin. Can be 5-60 seconds (default is 10)
alignleftSet the text to be aligned to the left / center / right of the box (default to center)
fontRobotoAccepts system and Google fonts
colorredPick a different text color. Accepts names or hex values (defaults to white)
bg#000000Pick a different background color. Accepts names or hex values (defaults to no background/transparent)
max10Set the maximum number of entries per user (default is 1)

© 2025 Mustached_Maniac. All rights reserved.