Skip to content
streamneo.
Troubleshooting12 min read

Why Does an OBS Property Tour Playlist Show a Black Frame Between Videos?

Trace black frames in an OBS property tour playlist by checking source type, item changes, scene transitions, visibility and source order.

sn.
StreamNeoPublished 4 October 2026
Worth sharing?

A black frame in an OBS property tour playlist can appear when one clip ends and another loads, but there is no single documented cause that explains every gap. First check whether you are using OBS’s VLC Video source and whether the black coincides with a playlist item change or a scene transition.

Those two timings point to different checks. A frame between files calls for an inspection of the playlist source and media; a frame during a scene change also calls for checking what the incoming scene displays when it becomes active. Work through the evidence before changing settings, because visibility, layering and playback behaviour can all affect what you see.

When does the black frame appear?

Start by noting exactly when the image turns black. If you can, record a short local OBS preview or make a note of the playlist item and scene at the time. You do not need a recording to begin troubleshooting, but a repeatable observation is more useful than changing several settings and trying to remember whether the gap improved.

There are two main timing patterns to separate:

What you see First area to inspect
Black appears between two files while the same scene remains active Playlist source type, item handoff, media files and source visibility
Black appears as you switch scenes Incoming scene, transition and sources that restart when activated
Part of the picture disappears, or a logo or colour remains visible Source order, visibility and overlays
The gap occurs only with certain files Those files’ duration, format and playback in the source

This table is a starting point, not a diagnosis. A scene change can happen at the same time as a clip change, for example, so test each event separately. Keep the playlist running in one scene to check item handoffs; then switch scenes without changing the playlist item.

For a property tour, look for a pattern across the actual presentation: does the gap follow every room-to-room clip, only one particular file, or only a change from the tour scene to a title card? A gap between the same pair of files each time makes those files or their handoff worth testing. A gap that follows a scene switch even when the clip is unchanged calls for a different branch of checks.

If the broadcast has already gone live, avoid making disruptive changes on air unless the black frame is more damaging than a brief interruption. Reproduce the sequence in an OBS scene collection or a private test first. This is especially useful when the stream is an always-on property showcase and viewers may arrive in the middle of a tour.

Identify the OBS playlist source type

Open the scene in OBS and inspect the Sources dock. Determine whether the tour uses the VLC Video source, several built-in Media Sources, or the Media Playlist Source plugin. These are different playback arrangements, and a setting that exists for one may not exist for another.

OBS’s Media Sources guide describes VLC Video as a source that can play a playlist. VLC must be installed for that source to appear, and the architecture must match: 64-bit OBS requires 64-bit VLC. The guide describes the built-in Media Source separately as a source for an individual media file, with its own playback and end-of-playback controls.

If you use one Media Source per room, the “playlist” may really be a sequence of scenes or sources rather than a VLC playlist. If you use a plugin, the source name and installed version matter. Confirm what is actually in the Sources dock rather than inferring it from how the tour was assembled.

The distinction changes the next step. With VLC Video, inspect its playlist and visibility behaviour. With individual Media Sources, check the settings on the source that goes black, especially if it is activated as a scene appears. With the plugin, reproduce the issue and compare the installed version and playlist state with its published update history. Do not assume that a plugin note proves your symptom has the same cause.

If a source is missing from the add-source menu, confirm whether VLC is installed in the appropriate 64-bit form before rebuilding the tour around another source. That is a source availability check, not evidence that VLC is responsible for a black gap. If you are weighing a different workflow for a prerecorded channel, the practical considerations in cloud platforms for a prerecorded YouTube livestream can help you compare the role of a local OBS setup with a cloud-based approach.

Check VLC playlist and visibility settings

If the source is VLC Video, open its properties and verify that the expected files are in the playlist and in the intended order. Confirm that each path still points to an available file. A moved file or a duplicate entry can make a playlist behave differently from the sequence you expect, so check the actual list rather than only the scene name.

OBS’s guide documents playlist controls such as loop and shuffle, along with visibility behaviour. The documented defaults are loop on and shuffle off; VLC Video is set to stop when it is not visible and restart when visible. Defaults can differ after a user changes them, so inspect the properties rather than relying on what a new source usually does.

Visibility is relevant if the source disappears from view because you switch scenes, hide it, or cover it with another source. If playback stops while hidden and restarts when it becomes visible, activation can be associated with a temporary black image as playback begins. That behaviour is worth checking when the timing matches, but it does not establish why a black frame occurs between consecutive items while the source stays visible.

Change one relevant setting at a time in a test scene. For example, keep the source visible and observe a complete handoff before altering loop or shuffle. Then test the visibility behaviour separately by hiding and showing the source. Record what changed. If you toggle multiple settings together, you may remove the symptom without knowing which condition mattered, making the next interruption harder to diagnose.

If the files are intended to play in a fixed room-to-room order, verify shuffle is off. If the list is intended to continue indefinitely, verify that looping is enabled and test what happens at the end of the list. Those checks address order and end behaviour; they should not be treated as guaranteed cures for a short gap during ordinary item changes.

Inspect scene transitions and source activation

If the black frame coincides with a scene change, test the incoming scene by itself. Select it directly or use a non-live test, then check whether its media source is already showing a frame before you transition into it. A source that begins playback only when it becomes active may not have a picture ready at the exact moment the transition starts.

For the built-in Media Source, OBS documents “Restart playback when source becomes active” as on by default, and “Show nothing when playback ends” as on by default. If the target scene activates a Media Source with restart-on-activation enabled, test whether the incoming source is black at the start of the transition. The setting is a plausible check for that specific timing pattern, not a universal playlist-gap remedy.

An OBS forum discussion about fading between scenes without a black frame describes a scene transition that begins from the frame the source is displaying at the time. That explanation concerns the transition scenario in that discussion; it does not establish that every black frame between playlist items has the same cause. If your symptom occurs only on scene changes, it gives you a reason to inspect the incoming source’s state at transition start.

If the source needs to restart on activation for the tour to begin at the first room, turning that behaviour off may change the intended playback. Test both the desired start point and the transition in a non-live setup. If it should continue where it left off instead, compare that result too. Keep the choice tied to the presentation you want, not to a blanket recommendation that all sources should restart or never restart.

Also test the transition type and timing without changing the media. Switch to a simple cut for one test, then restore the intended transition. If a cut is clean but a fade shows black, the source’s displayed frame during the fade deserves closer attention. If both show the same gap between playlist items while staying in the same scene, return to the playlist and files rather than assuming the transition caused it.

Check source order and overlays

A source can be playing correctly and still be hidden. In the Sources dock, OBS stacks sources: higher sources appear above lower ones and can cover them. The OBS Sources Guide explains this ordering. Check whether a black colour source, browser source, image, or other full-frame layer sits above the video.

Look at the preview during the black frame. If a logo, border, title card or background remains visible, that tells you some layers are still rendering while the video area is covered or absent. If the entire canvas turns black, inspect full-canvas sources and scene transitions as well as the video source itself. These observations narrow the possibilities; they do not prove which layer is responsible until you test it.

Use the eye icons in the Sources dock to hide one overlay at a time in a test scene. Avoid deleting sources during diagnosis: hiding is reversible and lets you restore the original layout. If you identify a covering layer, check whether it is meant to be visible for the whole tour or only during a title card. A scene-specific overlay may be better placed in the scene where it belongs than removed from the project altogether.

For a reusable property-tour layout, check each scene separately. A source can be ordered correctly in one scene and differently in another, particularly if the scenes contain separate copies of the same media source. The OBS guide to sources is useful when checking how the preview’s layer order maps to what appears on screen.

Test clips and settings one at a time

Once you know the source type and timing, reduce the test to a small, repeatable case. Make a temporary scene with the same source and two clips: one that usually precedes the gap and one that follows it. Test the pair more than once, then swap one file for a known-good clip. Keep the playlist order and scene state visible in your notes.

This helps distinguish an issue tied to a specific file from one tied to the source’s general handoff behaviour. Check that both files play to completion in the source and that the second begins as expected. If only one clip pair reproduces the gap, keep those files for further testing rather than changing the whole tour. Do not infer that every video encoded in the same way will have the same result from one pair alone.

Change only one condition between tests: source type, visibility, restart behaviour, transition, or the clip pair. Then note whether the black frame appears and exactly when. If you use the Media Playlist Source plugin, compare its installed version and playlist state with the published update history. The history records version-specific fixes, including playlist continuation after a transition and when the next video path is the same. Those notes are clues to compare, not proof that an update will solve your case.

Keep a short record with the OBS version, operating system, source type, VLC version if relevant, visibility and restart settings, transition, and the names of the test clips. If you need help from an OBS community forum, include those details and a concise reproduction sequence. “It goes black between videos” is harder to investigate than “it happens between these two files in a single visible VLC Video source, without a scene change”.

A property tour is a presentation, but its viewing pattern can resemble a continuous radio or ambience channel: viewers may join at any point, and interruptions are noticeable even when the content is prerecorded. If you are designing a separate time-based rotation, see how to keep a YouTube radio stream playing different playlists by time of day. For one repeating file rather than a tour playlist, looping a single video without a black screen covers a different workflow and should not be substituted for diagnosing a multi-clip source.

Choose a workflow that fits the channel

OBS is useful when you need live control over scenes, titles, narration or other elements during the tour. It also means the playback source, scene state and running computer are part of the broadcast chain. A property business that updates rooms frequently may value that control; a channel showing a prepared tour unattended overnight may prefer a workflow with fewer on-air decisions. Neither approach removes the need to check the finished playback before relying on it.

If a local OBS setup suits your needs, keep a simple test scene and a written record of the source settings that worked with your files. Do not make a live production change solely because a setting is commonly recommended for another kind of symptom. If your recurring problem is that the computer must remain on for a prerecorded stream, StreamNeo removes that specific burden by turning an uploaded video into a YouTube live stream that can run with your computer switched off; it does not replace OBS scene control for a live-produced tour.

For a stream made from a single prerecorded file, compare that approach with the constraints discussed in running a continuous YouTube stream on a Raspberry Pi. A playlist of property clips with overlays is a different job, so make the choice based on how often you need to change scenes, react live or update the source files. In either case, run a full playback test before using it as an unattended channel.

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

Is VLC Video the same as Media Source in OBS?

No. OBS documents VLC Video as a source that supports a playlist, while the built-in Media Source is for an individual media file. They also have different playback and visibility controls, so confirm the source in the Sources dock before following instructions for one or the other.

Should I turn off “Restart playback when source becomes active”?

Only test that setting when the black frame occurs as a scene or source becomes active and the source is a built-in Media Source. OBS documents the setting, and an OBS forum discussion describes a black transition frame in that context, but neither establishes it as the cause of gaps between all playlist items. Check that the revised behaviour still starts the tour where you intend.

Could a layer above the playlist make the screen black?

Yes, a source higher in the Sources dock can cover sources below it, according to OBS’s source-order guide. Hide likely overlays one at a time in a test scene and watch which parts of the preview remain. This is a check, not a guarantee that source order explains the symptom.

What information should I collect if the gap continues?

Write down your OBS version, operating system, source type, VLC version if applicable, visibility and restart settings, transition, and which clips reproduce the issue. Note whether the scene changed at the same moment. That makes it easier to compare your setup with the relevant documentation or ask for focused help.

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 ↗