Tutorials Streaming

What's Inside an OBS Scene File, and Why It Matters

Intermediate · ~12 min

Overview

An OBS scene collection isn't a video or an image. It's a structured data file describing every source, filter, and setting in your setup by reference, and understanding that distinction explains why moving a scene collection to a new computer sometimes breaks things, and why backing it up properly matters.

What You Need

No special equipment required. This is a technical explainer, not a hands-on tutorial

Steps

The simple version: a scene file remembers your whole setup

At the simplest level, a scene collection file stores everything about your OBS setup, which scenes exist, what sources (cameras, images, browser sources) are in each one, their position and size, and any filters or effects applied, so you can reopen OBS and have your entire setup back exactly as you left it.

What's really inside the file: references, not the actual media

Technically, a scene collection file stores structured data (in a format based on JSON) describing each source's type, settings, and file path references, for a source like an image or video file, the scene collection stores the path to that file on your computer, not a copy of the file itself, which is the key detail that explains several common scene-file problems.

Why moving a scene collection to a new computer can break things

Because media sources are stored as file path references rather than embedded copies, moving a scene collection file to a different computer without also moving the actual referenced media files (images, video clips, browser source files) to the same file paths will result in missing or broken sources, even though the scene collection file itself transferred correctly.

What this means for backup and sharing practices

A complete backup or sharing package needs to include both the scene collection file itself and copies of every referenced media file, ideally preserving the same folder structure and file paths, or manually reassigning file paths after transfer, simply copying the scene collection file alone is a common and easily avoidable mistake.

Pro Tips

When backing up or transferring your OBS setup, include both the scene collection file and all referenced media files (images, video clips, browser source assets), not just the scene collection file alone.
Keep your OBS media assets in a consistent, dedicated folder rather than scattered across your computer. This makes path-related breakage far less likely when moving to a new machine.
If sources appear as broken or missing after importing a scene collection on a new computer, check that the referenced file paths actually exist on the new machine before assuming the scene file itself is corrupted.

Knowledge Base

What You'll Learn

An OBS scene collection file stores your setup as structured data with file path references to media, not embedded copies of that media, understanding this distinction explains why proper backup and transfer requires moving both the scene file and its referenced assets together.

The Plain-English Version

A scene collection file is like a detailed instruction sheet saying 'put this specific image file from this specific folder here, at this size'. It's not a copy of the image itself. If you move the instruction sheet to a new house without bringing the actual image, the instructions point at a spot where the image no longer exists.

The Misunderstanding This Clears Up

People sometimes assume backing up just the scene collection file is a complete backup of their OBS setup, and are confused when sources appear broken after restoring it on a new or reinstalled system. The scene file was never storing the actual media, just references to where it used to live.

Where This Fits

This guide covers one specific part of livestreaming. The wider picture (scene and source structure, encoding, bitrate, and audio routing for a reliable stream) is in OBS Studio for Beginners, which frames the discipline as a whole and links out to the detailed guides underneath it, including this one. If you are starting from scratch rather than solving a specific problem, read that first and come back here.

FAQ

Q: Why do my images or video sources disappear when I import my OBS scene collection on a new computer?
A: OBS scene collection files store file path references to your media, not embedded copies of the actual files, if the referenced files aren't present at the same paths on the new computer, those sources will appear broken or missing even though the scene collection file itself transferred correctly.

Q: What's the correct way to back up my full OBS setup?
A: Back up both the scene collection file and copies of every referenced media file (images, video clips, browser source assets), ideally preserving the same folder structure, or be prepared to manually reassign file paths after restoring on a different computer.