Song Requests, music through your Twitch chat bot

Your «Secondary playlist» can be organized into «Collections», letting you quickly include or exclude entire groups of songs based on the genres or moods you want to listen to.

Follow these steps to organize your songs into a Collection:

1. Create a Collection by entering its name in the «Collection name...» input field and clicking the «Create» button.
2. In the playlist, select the songs you want to add to the Collection.
3. Click the «Move selected to Collection...» button.
4. In the pop-up, select the Collection you want to add the songs to.
5. Click the «Move» button.

Your songs should now be organized into the Collection, and you can easily include or exclude them by toggling the Collection on or off.

If you want to play a specific song from your «Secondary playlist», you can:

1. Queue it up by clicking the «Add to song queue» button for the song in the «Secondary playlist» menu, or
2. Play it immediately by clicking the «Play now» button.

To adjust the maximum total number of Song Requests in the queue, open the settings menu and change the value for «Maximum requests in the primary playlist».

You can set Moobot to automatically announce in Twitch chat when you're accepting Song Requests. This way, your viewers will know when they can send in their requests.

Moobot will start posting these announcements in Twitch chat whenever you play music from the dashboard's song player widget.

Simply activate the toggle and adjust the settings in the «Announcement» section of your settings to enable this functionality.

Moobot can be set to only accept Song Requests that you have pre-approved through your secondary playlist.

This allows you to control exactly which songs are played on your stream.

Your viewers will use your public music page to find the available songs and then request them as usual through the «!SongRequest» chat command.

To enable this functionality, simply activate the «Only accept songs from the secondary playlist» checkbox under the «Song filtering» section in the settings menu.

When your viewers attempt to request a song that is not in your secondary playlist, Moobot will direct them to your public music page to choose from your pre-approved songs.

You can restrict when Song Requests are open so that requests only come in when you want them to. This will prevent your request queue from getting filled up with old requests.

To specify who can request songs, select the user groups you want to accept requests from in the «Only accept requests from these user groups» input under the «User filtering» section in the settings menu.

Simply choose the desired user groups to accept requests from:

• Normal users (any users)
• Twitch subs
• (⁎) Twitch followers
• Twitch mods
• Moobot regulars
• Moobot editors

To allow each of your viewers to have a fair chance to submit their requests, adjust the «Max requests in the queue per user» to fit your needs. This will limit the number of requests a single viewer can queue up at one time.

YouTube has a vast library of songs, but not all of them may be what you want to listen to.

If you want to restrict requests to a certain YouTube category, you can do this by selecting your desired categories in the «Only accept requests from these YouTube categories» input.

You can also restrict requests to have a minimum amount of views on YouTube, which may help you avoid unwanted requests. Simply adjust the «Minimum amount of views» input to set the required minimum views.

To avoid one request taking up too much airtime, you can adjust the «Maximum length of song» input under the «Song filtering» section in the settings menu.

Moobot can automatically deny Song Requests with certain words in their title.

Simply add the words you want to blacklist to the «Song title filtering» input under the «Song title filtering» section in the settings menu.

You can exempt certain user groups from all your Song Request filtering by selecting the group in the «Exempt these user groups from any of the filtering» input under the «Filtering whitelist» section in the settings menu.

Exempting your Twitch followers and/or subscribers from session restrictions allows them to request as many songs as they want.

This encourages your viewers to follow and subscribe, while still enabling non-subscribers and non-followers to request songs.

Follow these steps to blacklist Song Requests from a Twitch viewer:

1. Open the «Features» menu from the main menu, then open the «Special Features» menu from there.
2. While in the «Special Features» menu, find the «Song Requests» feature and use the «Settings» button on the right-hand side of the feature to open its menu.
3. In the menu, select the «User blacklist» option, which will open up the blacklist menu.
4. Find the «Blacklist a user» input at the bottom of the blacklist menu, type in the user name of the Twitch viewer you want to blacklist, and then either select the user or press the ENTER key.
5. The «Blacklisted users» list should now display the blacklisted viewer.
6. (Optional) If you want to only temporarily blacklist the viewer, find them in the list and click on the «Edit» button to open its menu.
7. Activate the «Expiration» toggle and adjust the date and time to when you want the viewer to be removed from the blacklist.
8. Click the «Save» button at the bottom of the menu to save the changes.

Follow these steps to blacklist certain songs:

1. Open the «Features» menu from the main menu, then open the «Special Features» menu from there.
2. While in the «Special Features» menu, find the «Song Requests» feature and use the «Settings» button on the right-hand side of the feature to open its menu.
3. In the menu, select the «Song blacklist» option, which will open up the blacklist menu.
4. Find the «Add a YouTube video...» input at the bottom of the blacklist menu.
5. Paste the link/ID of the YouTube video or search for it and select the desired video from the list.
6. The blacklisted song will now be displayed in the «Blacklisted songs» list.

Follow these steps to blacklist Song Requests from an entire YouTube channel:

1. Open the «Features» menu from the main menu, then open the «Special Features» menu from there.
2. While in the «Special Features» menu, find the «Song Requests» feature and use the «Settings» button on the right-hand side of the feature to open its menu.
3. In the menu, select the «Channel blacklist» option, which will open up the blacklist menu.
4. Find the «Add a YouTube channel...» input at the bottom of the blacklist menu.
5. Paste the link/ID of the YouTube channel or search for it and select the desired channel from the list.
6. The blacklisted channel will now the displayed in the «Blacklisted channels» list.

Moobot offers curated blacklists for both songs and YouTube channels.

To activate the curated blacklist, go to the blacklist menu for songs and/or YouTube channels, activate the «Enable the global blacklist» checkbox, and click the «Save» button at the bottom of the menu.

The «!SongRequest» chat command is how your viewers request their songs, and they can use it in Twitch chat like this:

• «!SongRequest query», where the «query» is a search query. Moobot will then search YouTube for the query and choose the most relevant video.
• «!SongRequest video-ID», where the «video-ID» is a YouTube video ID. For example, for the YouTube video «youtube.com/watch?v=ABCDE» the video ID would be «ABCDE», and Moobot will accept either «ABCDE» or «v=ABCDE».
• «!SongRequest link», where the «link» is a link to a YouTube video.

The «!CurrentSong» chat command displays in Twitch chat which song is playing through the song player widget.

The «!NextSong» chat command displays in Twitch chat which song is playing next.

Your Twitch moderators can use the «!Volume» chat command to display and/or change the current volume of the song player widget.

The chat command can be used in Twitch chat like:

• «!Volume» to display the current volume.
• «!Volume value» to set the volume, where the «value» is a number from 1 to 100.
• «!Volume up» to increase the volume by 10.
• «!Volume down» to decrease the volume by 10.
• «!Volume up value» to increase the volume by «value» with the «value» being a number from 1 to 100.
• «!Volume down value» to decrease the volume by «value» with the «value» being a number from 1 to 100.

The «!SkipSong» chat command can be used by your Twitch moderators to skip the song currently playing in the song player widget.

The «!WrongSong» chat command removes the previously requested song of whoever uses the command.

Your viewers can use this chat command if they make a mistake with their request.

The «!SongList» chat command provides a link to your public music page.

This page offers several features that allow your viewers to:

1. View all song requests currently in the queue.
2. Learn how to request songs.
3. See which song is currently playing.
4. View a history of previously played songs.

Follow these steps to adjust the playback position of a song in your «Secondary playlist»:

1. Open the «Features» menu from the main menu, then open the «Special Features» menu from there.
2. While in the «Special Features» menu, find the «Song Requests» feature and use the «Settings» button on the right-hand side of the feature to open its menu.
3. In the menu, select the «Secondary playlist» option, which will open up the secondary playlist menu.
4. While in the secondary playlist menu, find the song you want to adjust the playback position for.
5. Click the «Set playback position» button for the song.
6. In the pop-up, change the start and end positions to your desired values.
7. Click the «Set» button to save the new playback positions.

You can adjust the playback position of a song requested with the «!SongRequest» chat command by providing a start and end playback position when using the command in Twitch chat.

To do this, add «start=00m00s» and/or «end=00m00s» to the chat command's request, where «00m» represents the minutes and «00s» represents the seconds. Additionally, prefix it with a «#» character and separate them with a «&» character.

Examples:

The playback position is not adjusted:

!SongRequest youtube.com/watch?v=ABCDE

The playback position is adjusted to start at 1 minute and 32 seconds and ends when the video completes:

!SongRequest youtube.com/watch?v=ABCDE#start=01m32s

The playback position is adjusted to start at the beginning (00:00) and end at 1 minute and 12 seconds:

!SongRequest youtube.com/watch?v=ABCDE#end=01m12s

The playback position is adjusted to start at 30 seconds and end at 1 minute and 45 seconds:

!SongRequest youtube.com/watch?v=ABCDE#start=00m30s&end=01m45s

By using the latest features in OBS you can easily capture the audio from Moobot's song player with the help of the «Application Audio Capture» source, allowing you to treat it separately from your other audio sources.

Here's how you can set it up:

1. Open OBS.
2. Set up all your audio sources to use separate sources instead of the global «Desktop Audio» which captures all audio on your device.
   1. Open the Settings menu by going to «File» > «Settings».
   2. Under the «Audio» section, find «Global Audio Devices» and disable «Desktop Audio».
   3. Apply the settings and close the menu.
3. Make a nested scene that will include all your audio sources, allowing you to use them in all your scenes without having to set them up repeatedly in each scene.
   1. Right-click in the «Scenes» box and select «Add».
   2. Name the scene something like «[NS] Audio Sources» (NS for Nested Scene) and click «OK» to create it.
4. Make sure your Moobot song player is open.
5. While your nested scene is selected, right-click in the «Sources» box and select «Add» > «Application Audio Capture».
   1. Name the source something like «Moobot Song Player» and click «OK» to create it.
   2. Select the window that contains the Moobot song player. Open the song player if it's not already listed.
   3. Set the «Window Match Priority» to «Match title, otherwise find window of same executable».
   4. Click «OK» to create the audio source.
6. Add the nested scene to all your other scenes where you want the audio to be played.
   1. In the «Scences» box of your OBS, select the scene you want to add the audio to.
   2. Right-click in the «Sources» box and select «Add» > «Scene».
   3. Select the «[NS] Audio Sources» scene and click «OK» to add it to the scene.
   4. Repeat these steps for all your scenes.
7. Set up any other audio you want to capture. Make sure you create them in your nested scene.
   1. Use the «Game Capture» or «Window Capture» source to capture your game.
      1. Capture the audio from this type of source by activating the «Capture Audio» checkbox in its properties.
   2. Create other «Application Audio Capture» sources for other apps you want to capture audio from.
   3. Capture the audio from your alerts.
      1. Use a «Browser Source» to capture your alerts and activate the «Control audio via OBS» checkbox in its properties.
      2. Or use a «Window Capture» source to capture the window that plays your alerts and then activate the «Capture Audio» checkbox in its properties.
   4. Your microphone should already be added and visible in the «Audio Mixer» as it is added as a «Global Audio Device» in your OBS settings.

All your audio sources should now be separated, allowing you to control them individually.

When you only have the rights to play certain music on your live stream but not in your recorded content (VODs), you can exclude any audio coming from the song player from your Twitch VODs.

This audio can be excluded both from your live recorded content that goes into your Twitch VOD archive, as well as any local recordings you make to upload to YouTube or other platforms.

Twitch's Copyrighted Audio Detection system is also quite unreliable, flagging audio inconsistently and often incorrectly flagging audio that you have the rights to play. Once flagged, Twitch will mute all the audio, including your mic and game audio. By excluding Song Requests entirely from your VODs, you can avoid this issue altogether.

You can easily do this by following these steps:

1. Separate the audio from your Song Requests from your other audio sources.
2. Under «Audio Mixer», open the «Advanced Audio Properties» by clicking the gear icon.
3. Find the audio source for your Moobot song player and set the «Tracks» to only «1». Deactivate all the other tracks.
4. Make sure that the other audio sources you want in your VODs have their «Tracks» activated.
5. Click the «Close» button to save the settings.
6. Open the OBS settings menu by going to «File» > «Settings».
7. Under the «Output» tab select «Advanced» in the «Output Mode» dropdown at the top of the menu.
8. Inside the «Output» tab, select the «Streaming» tab.
9. Activate the «Twitch VOD Track» checkbox.
10. Set the «Twitch VOD Track» to «2».
11. (Optional) Do the same in the «Recording» tab by activating audio track «2», which is the track that will have the Song Requests audio excluded. If you do not want to edit the audio tracks later, you can deactivate the other tracks if you have all your other audio sources playing on track «2».
12. Click «OK» to apply the settings.

Your viewers should now be able to hear the audio from your song player on your live stream, but the audio will be excluded from your Twitch VODs and local recordings.

Some YouTube videos can have very different audio levels, which can be jarring for your viewers when the player switches between songs.

To ensure that all your Song Requests are played at the same volume, you can set OBS to normalize the audio for your song player.

Here's how you can set it up:

1. Separate the audio from your Song Requests from your other audio sources.
2. Find the Moobot song player audio source in the «Audio Mixer» section of your OBS.
3. Right-click on the audio source and select «Filters».
4. Add a «Limiter» filter by right-clicking in the «Filters» section and selecting «Add» > «Limiter».
   1. Set the «Threshold» to «-20 dB», meaning the audio will be limited to this level.
5. Add a «Compressor» filter by right-clicking in the «Filters» section and selecting «Add» > «Compressor».
   1. Set the «Ratio» to «4:1» which is the industry standard for music.
   2. Set the «Threshold» to «-35 dB» or any other value that fits your needs.
   3. Keep the «Attack» value at «6 ms» and the «Release» value at «60 ms».
   4. Set the «Output Gain» to «15 dB» or any other value that fits your needs.
6. Close the «Filters» menu by clicking the «Close» button.

The audio from your song player should now be normalized, ensuring that your Song Requests are not too loud or too quiet.

You can test the filters by doing a recording within OBS and then listening to the recording to see if the audio levels are to your liking. You will not be able to hear the filters in real-time as they will not be applied to your desktop audio without further setup.

Please note that if you've excluded Song Requests from your recordings, you will not be able to hear the song player's audio in your recordings. In this case, you will have to temporarily switch the audio track of your recordings to hear the audio.

To ensure that your viewers can hear you clearly when you're talking, you can set up OBS to automatically lower the volume of the song player when you're speaking, and then automatically raise it again.

This is incredibly useful when you're streaming and want to talk to your viewers without the music overpowering your voice.

With OBS, you can create a natural transition between your voice and your music by using its audio ducking functionality.

Here's how you can set it up:

1. Separate the audio from your Song Requests from your other audio sources.
2. Find the Moobot song player audio source in the «Audio Mixer» section of your OBS.
3. Right-click on the audio source and select «Filters».
4. Add a «Compressor» filter by right-clicking in the «Filters» section and selecting «Add» > «Compressor». If you already have a «Compressor» filter from normalizing your Song Requests volume levels, create another «Compressor» filter and name it something like «Audio Ducking».
   1. Set the «Ratio» to «7:1», which is a mid-to-high ratio that will lower the volume significantly when you're speaking. Increase this value if you want the volume to be lowered even more.
   2. Set the «Threshold» to «-32 dB», which is when the compressor will start to lower the volume of the song player. This value can be adjusted to fit your needs.
   3. Set the «Attack» to «200 ms», which is the time it will take to reduce the volume of the song player when you start speaking.
   4. Set the «Release» to «850 ms», which is the time it will take to raise the volume of the song player when you stop speaking.
   5. Keep the «Output Gain» value at «0 dB».
   6. Select your microphone audio source in the «Sidechain/Ducking Source» dropdown.
5. Close the «Filters» menu by clicking the «Close» button.

The audio from your song player should now be lowered when you're speaking, and then raised again when you stop speaking.

You can also apply the same filter to your game audio or any other audio source you want to lower when you're speaking.

To test how it works, do a recording within OBS and then listen to the recording to see if the audio levels are to your liking. Note that the song player's audio will not be lowered for you in real-time as it will only be applied to your stream's audio.

Keep in mind that if you've excluded Song Requests from your recordings, you will not be able to hear the song player's audio in your recordings. In this case, you will have to temporarily switch the audio track of your recordings to hear the audio.

With Moobot Assistant, you can write the current song to a local file.

You can then use this file in your broadcasting software (like OBS or XSplit) to display the current song on your stream overlay.

You can also use an OBS plugin like Tuna to get the information and cover art for your current song.

This information can then be incorporated into your stream overlay in a more visually appealing way.

The plugin can automatically retrieve song information directly from Windows' Media Player Controls, which displays when you use your music player either through your browser or Moobot Assistant.

Simply follow the instructions on the plugin's page to set it up.

If you encounter the «Waiting for song to be requested, or added to the secondary playlist...» error despite having songs queued up, it indicates that the YouTube player failed to load properly.

To resolve this issue, clear your browser's cache and cookies, and then restart it.

If clearing the browser does not resolve the issue, a browser extension is often the culprit behind the player's failure. Try disabling all of your browser extensions and then attempt to play a song again. Using an incognito window in your browser can make this process easier, as the extensions will be disabled by default.

Once you have identified the problematic browser extension, permanently disable or remove it to prevent future failures.

To comply with YouTube's guidelines, you must resize the song player widget to ensure it is at least 200 pixels wide and 200 pixels high.

Follow these steps to resize the song player:

1. Open the «Interface» menu in the main menu, and ensure that the «Lock UI» toggle is deactivated.
2. Follow one or more of these steps:
   1. Make your browser's window wider.
   2. Use your browser's zoom feature (if available) to zoom out, giving the song player more space.
   3. Drag and drop the song player widget to a wider column on your dashboard.
   4. Use the «UI columns» menu to adjust the width of a column by dragging its slider to your desired size.
   5. Reduce the number of columns in the «UI columns» menu to give more space for each column.
3. Your song player should now be at least 200 pixels wide and 200 pixels high.