Leahnaya/SceneSwitcher
1
0
Fork 0
mirror of https://github.com/WarmUpTill/SceneSwitcher.git synced 2026-05-09 04:32:13 -05:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity
Page: Installation
Pages
Activate overlay to hide parts of the screen Advance through a list of scenes by hotkey Audio action Audio condition Automatically cycle through a list of scenes Automatically split recording of stream into chunks Automatically switch scene if a game capture's target window no longer exists Change capture window of Window Capture source Converting legacy tab entries to macros Creating a macro Cursor condition Date condition Exporting and importing individual macros FAQ General tab overview Home Hotkey Hotkeys to control counter in text source (e.g. death or win counter) Http action Installation League of Legends process based scene swtich Looping a set of media sources Macro docks Macro duration modifiers Macro properties Macro time restrictions Macros Media condition Media playlist with commercial interruptions Motion detection Pausing macros Performing actions only when transitioning from A to B Process condition Push‐to‐show source Random action Saving and loading settings Scene groups Scene item transform condition Scene item visibility Scripting Sequence action Set up hotkey to start and stop recording with fade from and to black Show text source with latest Twitch follower Show webcam only when speaking Slide Show condition Start other programs when starting OBS Starting and stopping the plugin Switch scenes randomly Switching scenes for Aitum Vertical plugin Toggle visibility of scene items on a timer Troubleshooting Twitch Category Changer Variables Video condition Websockets scene swwitcher obs
9 Installation
WarmUpTill edited this page 2026-05-01 23:50:58 +02:00
Table of Contents

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.

InstallWindows1

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

InstallWindows2

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

image

Manual install

Download the advanced-scene-switcher-*-windows-x64.zip archive and open it.
It contains two subfolders:

  • recommended/ - for recent OBS versions
    Extract the contents of this folder into C:\ProgramData\obs-studio\ (so the result is C:\ProgramData\obs-studio\plugins\advanced-scene-switcher\...).
    You can open that path quickly by pressing Win+R and typing %ProgramData%\obs-studio.

  • legacy/ - for older OBS versions, or if the recommended method does not work
    Extract the contents of this folder into your OBS installation directory (e.g. C:\Program Files\obs-studio\), merging the data and obs-plugins folders with the existing ones.

Steam

Download the advanced-scene-switcher-*-windows-x64.zip archive of the version of the plugin you want to install.
For Steam installations, open the legacy/ folder inside the zip, locate OBS in your Steam library, right-click → Manage → Browse local files, and extract the contents of legacy/ into that directory.

image

Extract the contents of the advanced-scene-switcher-*-windows-x64.zip archive into this directory, so that the contents of the data folder will be merged into OBS' data folder and the contents of the obs-plugins folder will be merged into OBS' obs-plugins folder.

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:

InstallMacOS1

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.

InstallMacOS2

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

1745399015955

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:

    image

    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:

    1745398902663

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.
  • ...

Home

FAQ

Example guides

Explanations