Skip to content
streamneo.
Troubleshooting12 min read

How to Add a Video Playlist to OBS Without Showing Black Gaps on YouTube Live

Set up an ordered, looping OBS playlist and troubleshoot black intervals without assuming separate files will transition gaplessly.

sn.
StreamNeoPublished 4 October 2026
Worth sharing?

For several videos in a fixed order, add OBS’s VLC Video Source, put the files in its playlist, and enable Loop Playlist to start the list again after the last item. That setting repeats the list; OBS does not promise gapless transitions between separate files, so you should not treat it as a way to guarantee that viewers will never see a black interval.

For one video that should repeat, use Media Source and enable Loop instead. The setup below helps you choose the right source, configure it, and check what viewers will actually see before you go live.

Choose a source for the playlist

The choice depends first on whether you have one file or several. OBS’s Media Sources guide distinguishes Media Source, which plays an individual media file, from VLC Video Source, which can play a playlist when VLC is installed. OBS describes the latter as allowing you to create a playlist of items, similar to an Image Slideshow. That is the relevant distinction; neither source choice is a documented guarantee of seamless transitions between different files.

What you want to play OBS source to consider What to know
One video on repeat Media Source Enable Loop. Suitable when the whole programme is already one file.
Several videos in a chosen sequence VLC Video Source Add and order the files, then enable Loop Playlist if you want the sequence to begin again at the end. VLC must be installed.
Several files with playlist-editing features from an add-on An optional playlist plugin Check its current version, operating-system support and OBS compatibility before installing. It adds a dependency and still does not establish gapless handoffs.

A practical example is a channel with a morning prayer, a set of bhajans and a closing devotional track. If those are three separate local files and must play in that order, a playlist source is the natural fit. If you have already edited the entire programme into one continuous video, Media Source may be simpler to configure and check.

An optional alternative listed on the OBS Forums plugin page is Media Playlist Source. Its listing describes it as an alternative to VLC Video Source and gives its own version and compatibility details; those can change, so verify them on the page before relying on it. Choose it only if its playlist-editing features address a real need and you are comfortable maintaining a plugin. Do not install it merely in the hope that it will eliminate black frames.

Add VLC Video Source to a scene

Open the scene that should show your playlist. In the Sources dock, select + and choose VLC Video Source. OBS’s Sources Guide explains that sources are added to a scene through this control. Depending on the OBS version, the dialogue and labels may look slightly different, but the source is the built-in option intended for a list of media files.

VLC must be installed for the source to work. OBS notes that when you use 64-bit OBS, you need 64-bit VLC. If the VLC source is missing, or files will not play through it, first check that VLC is installed and that its architecture matches OBS. Avoid troubleshooting playlist order or YouTube output until the source can play a file locally in OBS.

After creating the source, give it a name that helps you recognise its purpose, such as “Morning programme playlist”. If OBS offers to create the source as new or add an existing one, choose based on whether this scene needs its own playlist configuration or should reuse a source you have already set up. Confirm the source’s properties dialogue opens before continuing.

The playlist source must also be visible in the scene. In the Sources dock, an eye or visibility control can hide a source. If the source is hidden, it may be playing without appearing in the programme output. The layer order matters as well: OBS says sources higher in the list appear on top of lower sources. Put a background below the playlist video if it should sit behind it; check that an unintended image, browser source or colour source is not covering the video.

Add and order media files

In the VLC Video Source properties, add the local files you want in the playlist, then arrange them in the desired playback order. The exact control names can vary with OBS releases, so work from the playlist controls shown in your installed version. Keep Shuffle off when the sequence matters. OBS documents shuffle as randomising the list and notes that it is off by default.

Check the list itself rather than relying on filenames to imply the order. A channel might use “Opening”, “Main set” and “Closing” as a sequence; confirm that the items appear in that order in the source properties. If you use numbered filenames, remember that the playlist order is what matters once files have been added. Reorder them in OBS if necessary.

Use files that you can locate consistently. If you move or rename a file after adding it, the source may no longer be able to find it. Keeping programme files together in a clearly named folder makes later checks easier, especially if you update the playlist before a scheduled broadcast. This is file-management advice, not a claim that a particular folder structure affects transition quality.

OBS’s audio and video formats guide discusses supported containers and codecs. It describes MP4 as a de facto standard for internet video and MKV as compatible with every audio and video encoder supported in OBS. These are general format notes, not evidence that a file will play smoothly on your particular machine or that its boundary with another file will be seamless. Test the files you actually intend to use.

Before changing other settings, open each playlist item on its own in OBS. Confirm that it displays and that its audio is present if you expect sound. If a file fails by itself, troubleshoot that file or its format first. A playlist cannot correct a file that the source cannot play.

Enable Loop Playlist

In the VLC Video Source properties, enable Loop Playlist if you want playback to return to the first item when the final item ends. The setting concerns what happens when the list runs out. It is not a crossfade control, a transition duration, or a promise that the last frame of one file will join the first frame of the next without interruption.

Keep shuffle disabled if the list must always restart in the same sequence. With shuffle enabled, the files are randomised rather than played as a fixed programme. For a devotional channel, local news loop or study station with a deliberate schedule, that difference may matter more than the repeat setting itself.

VLC Video Source also offers visibility behaviour options, including stopping playback when the source is not visible and restarting when it becomes visible. Consider these if you switch between OBS scenes. If the playlist should continue while another scene is on screen, a setting that stops playback when hidden may not match your intent. If it should start from the beginning when you return to the scene, restarting on visibility may be useful. Check the settings in your version and test a scene switch; do not assume a hidden source behaves one particular way.

Once configured, preview the full sequence, not only the first clip. Watch each file boundary and the final-to-first loop. This is a practical check of your own setup, not proof that future playback is guaranteed to be gapless. If you plan to change the video on an active 24/7 stream, rehearse that change in advance so you know how the scene and playlist behave together.

Use Media Source for one repeating video

If you have one finished video that should repeat, add Media Source to the scene instead of building a VLC playlist. Select the file and enable Loop in the source properties. OBS lists common media extensions including MP4, TS, MOV, FLV, MKV, AVI, GIF and WebM; the presence of an extension in the list does not guarantee every file will play correctly in every setup.

This approach can be easier to reason about when the content is already one continuous programme. For example, you might edit a complete ambience film or a sequence of short notices into a single file, then let Media Source repeat that file. It avoids the need to set a playlist order, but it does not make a guarantee about playback at the end-to-start boundary of the single file. Check that boundary in your own scene.

If you are deciding between an ordered list and a single prepared programme, consider how often the content changes. A playlist is easier to rearrange when you regularly swap individual items. A single file means changes require preparing and replacing the combined video. Neither approach is universally better; the useful choice is the one you can maintain and test reliably.

You may see advice to select a particular container or increase caching to solve black intervals. OBS documents caching as a VLC source setting, but the reviewed documentation does not establish that increasing it fixes gaps between local files. Likewise, OBS’s format guidance is not a promise that any one container makes transitions gapless. Treat such changes as things to test only when they address a specific observed playback problem, not as a guaranteed fix.

Understand possible handoff gaps

A playlist can play files in sequence and loop at the end, yet viewers may still see a brief black interval at a boundary. The official OBS documentation describes playlist and looping capabilities; it does not promise gapless handoffs between separate files or identify one universal setting that removes black frames. Be careful not to infer more from Loop Playlist than the setting says.

First distinguish a file-boundary interval from a source or scene problem. Watch the OBS preview while the sequence runs. If the video is absent for more than just a boundary, check whether the VLC source is visible and enabled, whether another source is covering it, and whether each file plays on its own. Check the Sources order: an item above the playlist may appear on top and obscure it. If the source disappears only when switching scenes, review the visibility behaviour settings.

If VLC Video Source is absent or does not play the files, confirm that VLC is installed and that its architecture matches the OBS build, especially when using 64-bit OBS. Then test an individual file in the same scene. This narrows the problem without changing several settings at once. If the source and every file work individually but an interval remains at file boundaries, the issue may be specific to the handoff; the documentation does not identify a single guaranteed remedy.

For a case where uninterrupted imagery is essential, one practical workaround is to edit or encode the clips into one continuous file and play that file as a looping Media Source. This is an inference about simplifying the playback sequence, not an OBS guarantee: the combined file and its loop point still need to be checked in the actual scene. Keep a copy of the original clips so you can revise the programme without losing the individual source material.

If your larger problem is that the broadcast itself stops, that is separate from a playlist boundary. Use a channel-level checklist such as how to find the cause of an overnight YouTube Live stoppage, rather than treating every black interval as a stream disconnection. For a playlist that is also part of a long-running channel, consider how you will restart an OBS loop after a crash; recovery planning does not remove file-transition gaps, but it addresses a different failure mode.

Rehearse the whole scene before going live

A short preview of the first file is not enough to check an ordered programme. Let the playlist run through every item, including the transition from the final item back to the first. Confirm that the correct file appears at each point, the scene remains visible, and any intended audio is present. If the full programme is too long to rehearse in one sitting, at minimum test the boundaries and settings that matter, while recognising that a partial check is not the same as observing a complete cycle.

Check the programme output as well as the source properties. Make sure the playlist source is not hidden, that intended background layers sit beneath it, and that an overlay or holding screen is not unintentionally covering the video. If you use a countdown or holding screen for a church stream, verify how it enters and leaves the scene alongside the playlist; the transition between scenes is a separate thing to check from the transition between files.

Write down which source you used, whether loop and shuffle are enabled, and how the scene behaves when hidden. A simple record is useful if you return to the setup after an update or a content change. OBS labels and plugin compatibility can change between versions, so recheck the actual controls after updating rather than assuming an old guide matches your screen.

If you have tried the built-in source and still need a dependable 24/7 operation without leaving a computer running, StreamNeo can remove the specific burden of keeping your own OBS machine on and restarting it when a broadcast drops; it does not change the fact that separate playlist files may show a handoff gap, so preview the content and choose the workflow accordingly.

Before committing, compare the operating options on the pricing page. When the file and channel are ready, start free — 24-hour trial, no card.

FAQ

Does Loop Playlist prevent black gaps between files?

No. It tells the VLC Video Source to start the list again after it reaches the end. OBS documents looping, but does not promise gapless transitions between separate files.

Do I need VLC for a VLC Video Source?

Yes. VLC must be installed for that source to work, and OBS says 64-bit OBS requires 64-bit VLC. If a file will not play, verify VLC and test the file on its own in OBS.

Should I use Media Source or VLC Video Source?

Use Media Source with Loop for one repeating video. Use VLC Video Source for a playlist of several files, especially when their order matters; keep shuffle off for a fixed sequence.

What can I do if gaps remain at file boundaries?

Check visibility, source order, VLC installation and whether each file plays individually. If only boundaries remain and uninterrupted imagery is essential, combining the clips into one file is a practical workaround to test, not a guarantee that the resulting file will be gapless.

YOU’VE REACHED THE END

Keep the ideas coming.

More guides, useful tools and a little help for your next broadcast.

Back to the journal ↗
YOUR NEXT READ

A little more to explore.

More Troubleshooting guides ↗ · All topics ↗