Supported Bit Versions
  1. 64-bit
Source Code URL
Minimum OBS Studio Version
Supported Platforms
  1. Windows
  2. Mac OS X
  3. Linux
Media Playlist Source


An OBS Plugin that serves as an alternative to VLC Video Source. It uses the Media Source internally.


  • Allows editing the playlist without restarting the video, even if files are
  • Allows editing any setting without restarting the video.
  • Saves the currently playing file so it would be played when OBS restarts.
  • Allows selecting a file or folder item from the list to play.
  • Shuffling (Based on VLC 4's implementation)
    • Allows adding/removing items from the playlist without the need to
      reshuffle. The shuffling order of already played items will be saved, so
      clicking Previous Item will still play the previous item. Selecting a file or
      folder item also does not break the history.
    • Reshuffles when the last file in the playlist is played out, without
      affecting history.
  • Shows the filename of the current file in the Properties window.
  • Has an option to play the first file or the current file when the source is

  • The Properties window will show the filename of the current file, but it can
    not be automatically updated when the video ends as it could cause OBS to crash
    when the video ends while interacting with the Properties window. Reopening the
    Properties window will refresh the shown current file.
  • While this plugin works with OBS 30 and up, it requires this change at that allows this plugin to
    save the index of the current file, so that restarting playback is not needed
    when editing the list. This change isn't merged yet as of OBS 30.0.2.
    A custom build with this PR is available
  • Does not support audio track or subtitle selection yet.
  • Does not automatically refresh folder contents yet, but can be manually done
    by saving the settings again.
For Developers

To find out the keys used in the source settings, use obs_data_get_json to view it, or check the scene collection json. You could also check src/media-playlist-source.c

To select a file programmatically:

proc_handler_t *ph = obs_source_get_proc_handler(source);
struct calldata cd = {0};
calldata_set_int(&cd, "media_index", 3); // 4th file
calldata_set_int(&cd, "folder_item_index", 3) // 4th folder item of the 4th file
proc_handler_call(ph, "select_index", &cd);
media_index - the 0-based index of the file in the playlist

folder_item_index - the 0-based index of the folder item in the folder at media_index

If the file at media_index is not a folder, the second parameter is ignored. If media_index is higher than the playlist item count, it will be set to 0. If folder_item_index is higher than the folder item count or media_index, it will be set to 0.

Contact Me

Although there is a Discussion tab in these forums, I would see your message faster if you ping me (@CodeYan) in the OBS Discord server, in #plugins-and-tools. Please do report bugs or if there are features you'd like to be added.


You can donate to me through PayPal to support my development. Thank you!
  • Like
Reactions: ASchneider
First release
Last update
5.00 star(s) 1 ratings

More resources from CodeYan

Latest updates

  1. 0.0.7

    Add "Close File when Inactive" option. Note that the plugin already only loads one file at a...
  2. 0.0.6

    Fix crash with empty or shuffled folder Thanks to @KronosRazer on OBS Discord server for...
  3. 0.0.5

    Fixed hotkeys and playback behavior Fixed hotkey names not appearing properly Fixed next and...

Latest reviews

Audio doesnt stutter like the VLC version does in some use cases. Interesting being able to access individual files directly in properties. Excellent alternative.