stblassitude / obs-scene-transporter

Import and export scene collections incl. assets

OBS Scene Transporter

Package OBS Studio scenes into a convenient ZIP file, including all assets, and import them again. Works across Linux, macOS and Windows.

Overview

OBS Studio can export the JSON file for a scene collection, but it does not copy the images, video, etc. that might be used in that collection. Also, the JSON file will contain absolute paths that are unlikely to work on another computer. obs-scene-transporter will collect all referenced asset files and fix the paths to them in the JSON file.

In addition, the IDs of certain sources are updated on the fly to adapt them to the target operating system on import. OBS Studio uses platform-specific IDs for camera and screen sharing sources. For example, when you import a scene collection that was created on Windows into a Linux system, the sources cannot be used and need to be created from scratch. By patching the IDs on the fly, OBS Scene Transporter allows these sources to be used on another computer with minimal configuration. In particular, the positioning of the sources is maintained, and it is only necessary to select the correct camera or screen on the new computer.

Installing and Running

Use pip to install this package:

$ python -m pip install obs-scene-transporter

The package installs a command-line tool obs-scene-transporter which you can run directly:

$ obs-scene-transporter -h

Alternatively, you can run the module:

$ python -m obsscenetransporter -h

Exporting a scene collection

Use the list command to obtain a list of scenes in OBS Studio:

$ obs-scene-transporter list
summer-conference
castle-wolfenstein-speedrun

Then use the export command to create a ZIP archive of the scene collection and all assets:

$ obs-scene-transporter export summer-conference summer-conference.zip

Importing a scene

Run the ìmport command to import a ZIP archive into OBS:

$ obs-scene-transporter import summer-conference.zip

If you'd like to import the collection under a different name, use the -n option:

$ obs-scene-transporter -n fall-conference import summer-conference.zip

Documentation

The main class of the package has limited documentation in the source code, see obsscenetransporter/__init__.py.

Running tests

python -m unittest discover -s obsscenetransporter/tests