Resource icon

Advanced Scene Switcher 1.18.0

Supported Bit Versions
  1. 64-bit
Source Code URL
Minimum OBS Studio Version
Supported Platforms
  1. Windows
  2. Mac OS X
  3. Linux
This plugin will allow you to automate various tasks using "Macros".
Macros consist of a list of conditions under which a list of actions will be performed.


Currently supported condition types are:
  • Audio
  • Cursor position
  • Date and time
  • File
  • Filter
  • Hotkey
  • Idle detection
  • Macro
  • Media
  • OBS statistics
  • OpenVR
  • Plugin state
  • Process
  • Recording
  • Replay buffer
  • Scene
  • Scene item order
  • Scene item transform
  • Scene item visibility
  • Source
  • Streaming
  • Studio mode
  • Timer
  • Video
  • Virtual camera
  • Websocket
  • Window title
Currently supported action types are:
  • Audio
  • File
  • Filter
  • Hotkey
  • Http
  • Macro
  • Media
  • Plugin state
  • Profile
  • Random
  • Recording
  • Replay buffer
  • Scene collection
  • Scene item order
  • Scene item transform
  • Scene item visibility
  • Screenshot
  • Sequence
  • Source
  • Streaming
  • Swap scene in Studio mode
  • Switch preview scene in Studio mode
  • Switch scene
  • System tray notification
  • Timer
  • Transition
  • Virtual camera
  • Wait
  • Websocket

Select "Go to download" for download and not "Source Code URL".


If you prefer to rely on the old tab setup and they are currently hidden, you can show them again by unchecking the "Hide tabs which can be represented via macros" option on the General tab.

Settings configuration:
Below is a short description on how to set up an automated scene switch if the output of a video source has not changed for a specified duration.

I assume the plugin is installed so let's open the settings.
To do so go Tools -> Advanced Scene Switcher.

You will end up on the "General" tab of the plugin.
Here we can make sure that the plugin is running by clicking the "Start" button if necessary.


Next we switch to the Macro tab to set up our automated scene switch. (1)
Here we add a new macro by clicking the plus symbol on the lower left (2) and enter a name for our new macro.


Now we have to add the condition we want to trigger the automated scene switch by clicking the corresponding plus symbol (1) and selecting the type of the condition we want to use (2).
As we want use video based scene switching we select the type "Video".


The next step is to configure the settings of this condition.
We select the video source we want to monitor (1) and the type of monitoring we want to take place (2).
For this particular use case we choose "hos not changed".
Finally we add the time constraint by pressing the small clock icon (3).


For the time constraint we specify the type of constraint (1) we want to choose and specify the duration (2).
In this case we select "For at least" and "3 seconds".


As a last step we have to specify the action that has to be performed if the condition we specified above is true.
To do this we have to add a new action to our macro by pressing the plus button in the lower middle of the macro tab.


The default action that is chose is already our desired one - "Switch scene" - so we do not have to adjust the type of the action.
However we have to select the scene we want to switch to (1) the transition type we want to use (2) and the duration of the transition (3).
(The duration can be left at "0" to use whatever is configured as the current transition duration)


Now everything should be set up and the scene should be switch accordingly.

A few more examples and guides can be found in the wiki.
Feel free to contribute your own examples! :)

Installing the plugin:
Recommended: Run the provided installer. (You might have to click 'More info' and select 'Run anyway' if it is blocked by Windows)

Alternatively manually copy the 'obs-plugins' and 'data' folders in the respective OBS Studio installation directory.
It is usually located at 'C:\Program Files (x86)\obs-studio\'.
Install the Visual C++ Redistributable for Visual Studio 2019, if you have not done so already.
64bit: vc_redist.x64.exe
32:bit: vc_redist.x86.exe
Recommended: Run the provided installer. (You might have to right click and select 'open' if it is blocked)

Not recommended: Alternatively manually extract the file and data folder from the advanced-scene-switcher-macos-*.pkg file and either ...

... right click the OBS app inside your Applications folder and choose 'Show Package Contents'.
Copy the file to 'Contents/Plugins' and the 'data' folder to 'Contents/Resources'.

... or copy the file to Library/Application Support/obs-studio/plugins/advanced-scene-switcher/bin/.
And the 'data' folder to 'Library/Application Support/obs-studio/plugins/advanced-scene-switcher/'.
Note that the plugin has dependencies to:
* libXss
* libXtst
* libcurl
* libopencv-imgproc
* libopencv-objdetect

If you are using snap you can install the following package for an OBS installation which comes bundled with the plugin:
sudo snap install obs-studio

The plugin is also available via the Flatpak package manager for users who installed OBS via Flatpak:
flatpak install com.obsproject.Studio.Plugin.SceneSwitcher

If you have installed OBS via other means, it is most likely necessary to install the plugin manually.
To do so copy the file and into the OBS Studio plugin folder.
The location of this folder can vary, so you might have to look around a bit.

Examples are ...

Unfortunately the expected location of the locale, which can be found in the data folder, can vary also.
The data folder, usually should be copied to:

If this does not work you can try to copy the "locale" folder found inside the data folder to:

In doubt, please check where other "en-US.ini" files are located on your system.

Additional Information and Notes:
If you want to build the plug-in yourself the source is available here.

Please report any problems you experience using this plug-in here, on GitHub or send me a direct message.
First release
Last update
4.57 star(s) 56 ratings

More resources from Warmuptill

Latest updates

  1. OBS 28 support and more

    Important note: You will have to use at least OBS 28 to use this version of the plugin! Please...
  2. Bug fixes and minor additions

    Additions: Improved the date condition: Added the option to select "before" and "after" for...
  3. Improvements to UI, video, audio and media related functionality

    Additions: Improved the video condition type: Added the option to apply the condition checks...

Latest reviews

Enables a whole new level of automation for OBS, especially with the Macros feature.
Essential plugin
In my previous review I had some feedback to be improved. Still gave it 5 stars.

All of those improvements has happened. I would rate this 10/5.

This plugin shouldn't be 'advanced scene switcher', it does SO much more. Almost anything you'd want to automate, this can do it.

This plugin is currently my #1 plugin for OBS, and provides features that in the future hopefully will be default to OBS.

Can only recommend.
Fixed a major issue I had with a program that would always white screen when launchingit to capture (no more flashbangs for the viewers) and can do the job of two other scripts I needed for specific functions. A must have for me now.
I was looking for a way to trigger a scene switch according to the time. I have a 15-minute countdown that plays over a wide shot before the church service begins. With Advanced Scene Switcher, I was able to do it exactly as I wanted.
This isn't just a Scene Switcher, it does SO much more than that.
I don't even use it for switching scenes to be honest..

Its one of the most useful plugins for OBS Studio.
I love it! I entirely use the macro section and I love it. It makes streaming, only while streaming, almost effortless. Although, it's the preparation that can be time consuming but I already had previous experience with macros. I used an Android macro app (unfortunately it doesn't work with my current phone - that does make me angry because I can still download it) as an impression of what coding is like and I even loved it then. I'm still going to school but I haven't gone back since the pandemic and my experience with my first professor's own book. He used his own typo-filled education book. Anyways, I intend on going back to school after the pandemic ends.
This is a really well done plugin, and I am now reliant on this plugin for switching my scenes upon media states (it even allows switching depending on remaining time, which is great for media sources as you won't have to see the video go black). The macros are also really powerful, allowing you to execute a sequence of actions.
Im not pro in OBS, but this plugin really brings up my beginner levels to a notch higher than I could if i spend someone to coach me and improve my OBS scene management skills.
This plugin has come a long way. It's now fancy as all hell!
Absolutely love the ideas and the dedication the developers have put into it. With the Macros Scripting it makes my insanely intricate setups a breeze. ❤