Omanges Random Song Picker (RSP) v2.0

Omanges Random Song Picker (RSP) is a custom-built extension for Streamer.bot that allows Twitch streamers to play a random song from a curated list when viewers redeem a channel point reward. This system dynamically sets media sources in OBS, shows the currently playing song in chat, and auto-hides the media when finished.

---

🎯 Key Features

• 🎵 Random Song Selection
  Picks a song at random from a list defined in a .txt file, ensuring no immediate repeats.

• 🤖 Channel Point Integration
  Triggered via a Twitch channel point reward; no chat command is required.

• 🖥️ Dynamic OBS Media Source
  Automatically sets a single media source in OBS to the selected song, eliminating the need for a separate source per song.

• ⏱️ Auto-Hide Media
  After the song finishes (based on the song's duration in milliseconds), the media is automatically hidden and ready for the next selection.

• 📝 Easy .txt Song List
  Maintain a simple song_name, duration_ms format for each entry in a .txt file.

---

🧰 Requirements

• Streamer.bot v1.0.1 or newer
• OBS with OBS WebSocket enabled
• Channel point reward set up for triggering the RSP

---

📦 Installation

1. Import the Extension

• Download or clone this repository
• Open Streamer.bot
• Go to Actions → Import → Select the .sb file included in this repo

2. Create Your Channel Point Reward

• In Twitch, create a channel point reward (name it anything you like, e.g., Play a Random Song)
• Link the action in Streamer.bot to this reward
• No chat command is required unless desired

3. Update the Media Folder Path

• In the RSP action, locate the Set Argument sub-action for RSP_MediaFolder
• Update the value from the placeholder path:

C:/CHANGE/THIS/PATH/Songs/

to the folder on your system where the song .mp3 files are stored

4. Run the Setup Action

• Click Test on the setup trigger in Streamer.bot
• This creates the necessary scene and media source in OBS automatically

5. Update Sub-Actions to Point to Correct Scenes & Sources

• In the RSP action, update the Set Media Source, Set Media State, and any other relevant sub-actions to point to:
  • The music source
  • The media source
  • The RSP scene source
• The setup action creates a separate scene for the RSP. Add this scene as a source wherever you want the RSP to be active in your main OBS scenes.

6. Add Songs

• Place all .mp3 songs in the folder you defined
• Update the .txt file in StreamerBot\Omanges Extensions with the format:

Song Name, Song Duration in ms

---

🔄 How It Works

✅ Viewer Redeems Channel Point Reward

1. User redeems the reward.
2. Script selects a random song from the .txt list.
3. OBS media source is updated to the selected song.
4. Song is unhidden in OBS and plays for the defined duration.
5. Song automatically hides after the duration.

---

💡 Examples

Example .txt File

LIZARD x GNARLY, 25000
LIZARD x CRAZY, 30000
LIZARD x CHILL, 18000

Example Chat Message

@username redeemed LIZARD x GNARLY

---

🧑‍💻 Developer Notes

• Only one media source is required in OBS; the script dynamically changes its file.
• The setup action handles creating the scene and media source automatically.
• The delay for auto-hiding is pulled from the song duration in the .txt file.
• Remember to add the RSP scene as a source in any main scene where you want the RSP active.

---

📞 Support

Join the SIDOR Community Discord to get help, suggest features, or just hang out with other creators using this system.

---

💬 Feedback or Contributions

• Open a pull request
• Create an issue with your suggestion
• Or fork it and customize it yourself

Check out GitHub Issues for discussions and requests.

---

👤 Author

Omanges
🟣 Twitch: twitch.tv/omanges
💬 Join the SIDOR Community Discord

---

📄 License

MIT License
You’re free to use, modify, and share this—just give credit.