OBS Random Video Player

Play videos in random order!

Perfect for BRB screens!

Notice: the VLC Source now supports "Shuffle playlist" option.

Download

Discord Support

Instructions

1. Download the latest executable for your system from above
2. Place the executable into the folder where your video/audio files you want to use are located
3. Run the file and follow the prompts for your settings
4. A new file called obs-random-videos.html will be created in the same folder
5. Add a new Browser Source to OBS
   1. Check "Local File" and select the new obs-random-videos.html you just created.
   2. Copy this path
   3. Uncheck "Local file" and set the url to file://<paste the path you copied>
      1. Windows example: file://C:/obs-videos-folder/obs-random-videos.html
      2. Mac/Linux example: file:///obs-videos-folder/obs-random-videos.html (note the /// instead of //)
   4. Set the width and height to your full canvas resolution
   5. Check "Shutdown source when not visible"
   6. If you want a new shuffle each time: check "Refresh browser when scene becomes active"
   7. Leave "Page permissions" set to "Read access to OBS status information"
6. Rerun the executable when you add or remove videos or want to change any settings

Supported files

Video

• mp4
• m4v
• webm
• mpeg4

Audio

• mp3
• ogg
• aac

Notes

• VLC Source now supports "Shuffle playlist"
  • This may be a more stable alternative to this project
  • Mac's with M1 chip: Install the Intel version of VLC to use the VLC plugin
• Set Refresh browser when scene becomes active
• Video resolutions should match your canvas aspect ratio
• Autoplay only works in OBS!
  • To test in your browser you must hit the Play button first
• Pro tip: webm videos support transparency (convert mov to webm to save on file size)

Stuck? Or nothing happening?

1. Try hitting Refresh cache of current page in OBS
2. In OBS go to Scene Collection then New
   1. Add only your random video browser source and see if this works
   2. If it works, then theres an external issue. I have no idea what is causing this so, if you have any info on this us know in the discussions
3. Enable remote debugging and open the page for the browser source
   1. Open Chrome Dev tools
   2. Application tab
   3. Make sure Local and session storage box is CHECKED
   4. Click Clear site data
4. If issues persist: use GitHub Discussions or join the Discord server

TODO

• Audio-only or video-only modes
• Option for cross-fading between videos
• Option to HTML background color
  • Good for videos with weird aspect ratio
  • Good for audio files
• Switch to Bubble Tea instead of promptui