Import and export OBS Studio scenes including all assets
Project description
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 summer-conference summer-conference.zip
Importing a scene
Run the ìmport
command to import a ZIP archive into OBS:
$ obs-scene-transporter 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 summer-conference.zip
Documentation
The main class of the package has limited documentation in the source code, see obsscenetransporter/__init__.py
.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for obs-scene-transporter-0.9.12.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | cf2a2dfd92fbfa57baf968f70e44fef090a45119d840fd656a58170934b7748d |
|
MD5 | 7ce68a1c296e48850c69f43588e5c2f9 |
|
BLAKE2b-256 | 746296536a0b06abac29082c93bc2626ddf8a5a6c835772286e6f5dda9b044f5 |