Installation

This wiki page will describe some of the different installation methods available for each OS:

Windows

Installer

Download the advanced-scene-switcher-*-windows-x64-Installer.exe file of the version of the plugin you want to install.

Next open the downloaded installer and click on "More info" and "Run anyway" and follow the installer's instructions.

The installer detects the installed OBS version and places the plugin files accordingly. If no OBS installation can be found, it will ask which OBS version you are using.

Once the installation is complete open up OBS and the Advanced Scene Switcher entry should be available in the Tools menu:

Manual install

OBS 33 changed the folder structure plugins are loaded from. Pick the zip archive matching your OBS version:

• advanced-scene-switcher-*-windows-x64.zip - for OBS 33 and newer (recommended)
  Extract the contents directly into C:\ProgramData\obs-studio\plugins\
  (press Win+R and type %ProgramData%\obs-studio\plugins to open that folder).
  The result should be C:\ProgramData\obs-studio\plugins\advanced-scene-switcher\advanced-scene-switcher.dll.
  For a portable OBS install, extract the contents into the plugins folder of your OBS installation directory instead.

• advanced-scene-switcher-*-windows-x64-obs32.zip - for OBS 28 to 32
  Extract the contents directly into C:\ProgramData\obs-studio\plugins\.
  The result should be C:\ProgramData\obs-studio\plugins\advanced-scene-switcher\bin\64bit\advanced-scene-switcher.dll.

• advanced-scene-switcher-*-windows-x64-portable-obs32.zip - for OBS 32 and older, portable installs of those versions, or if the archive above does not work
  Extract the contents into your OBS installation directory (e.g. C:\Program Files\obs-studio\), merging the data and obs-plugins folders with the existing ones.

Plugin releases made before OBS 33 was supported only provide two archives: advanced-scene-switcher-*-windows-x64.zip uses the OBS 28 to 32 layout described above and advanced-scene-switcher-*-windows-x64-portable.zip corresponds to the portable-obs32 archive.

Steam

For OBS 33 and newer follow the manual install steps using the advanced-scene-switcher-*-windows-x64.zip archive.

For OBS 32 and older download the advanced-scene-switcher-*-windows-x64-portable-obs32.zip archive of the version you want to install.
Locate OBS in your Steam library, right-click → Manage → Browse local files, and extract the contents of the archive into that directory, merging the data and obs-plugins folders with the existing ones.

Once the extraction is complete, launch or restart OBS and the Advanced Scene Switcher entry should be available in the Tools menu.

MacOS

Installer

It is recommend to download the *.pkg installer file of the desired version of the plugin:

Next you will have to "right-click" on the downloaded *.pkg file and select "Open". Then click "Open" again and click through the installer's instructions.

Once that is complete launch OBS and you should be able to see the Advanced Scene Switcher entry in the "Tools" menu:

Notes

• It might be necessary to remove quarantine flag from the pkg file you downloaded, if you see a dialog like this, when trying to run the installer:

  

  To do so run the following command in a Terminal window:

  xattr -d com.apple.quarantine Downloads/advanced-scene-switcher-*-macos-universal.pkg
  

• On some MacOS versions and depending on its security settings you might also have to explicitly allow the plugin to be loaded:

  

Manual install (not recommended)

If you want to manually install the plugin you will have to download the advanced-scene-switcher-*-macos-universal.tar.xz archive of the plugin version you want to install.

Now copy the contents of this archive to:

~/Library/Application Support/obs-studio/plugins/advanced-scene-switcher.plugin

Afterwards open up the "Terminal" application and run this command:

codesign --force --deep --sign - ~/Library/Application\ Support/obs-studio/plugins/advanced-scene-switcher.plugin

This will ensure that the plugin files are properly "signed" after they were installed manually. If this step is not performed OBS will fail to launch with an error similar to this one:

Exception Type: EXC_BAD_ACCESS (SIGKILL - Code Signature Invalid)
Termination Reason: Namespace CODESIGNING, Code 2 Invalid Page

Linux

Prebuilt release binaries

If you are using Ubuntu 24 you can download and install the prebuilt deb package available with each release. So, for example:

advanced-scene-switcher-1.29.3-x86_64-linux-gnu.deb

Prior to version 1.29.0 the release binaries were built for Ubuntu 22 environments.

Flatpak

A Flatpak package is available and can be installed via:

flatpak install com.obsproject.Studio.Plugin.SceneSwitcher

Note that due to the Flatpak sandboxing some functionality might be limited.

Other

Some distributions offer the option to install the plugin via their respective package manager.
For example:

• Debian: obs-advanced-scene-switcher
• Arch Linux (AUR): obs-advanced-scene-switcher
• Fedora & RHEL/EPEL 9: There is a COPR repository available here, providing the obs-studio-plugin-advanced-scene-switcher package.
• ...