Input Mode

Change Current Transition

This input Action changes the current transition (and its duration) used between scene switches.

The Transition output Field controls what to set the current transition to. This will show all available transitions that OBS Studio is using.

The Duration output Field controls what to set the transition’s duration to. This value is measured in milliseconds (ms). The Cut transition does not utilize this Field.

By using the Ignored Field mode on the Duration output Field, you are able to change the current transition without changing the duration each time the Action is executed.

Set Transition Bar

This input Action updates the percentage of transition along the transition bar.

This Action will only work properly when Studio Mode is enabled.

The Position output Field controls how much of the transition has passed. This is measured in a 0-1024 scale, with 0 indicating the transition has not started, and 1024 indicating the new scene is fully showing. A value of 512, for example, would indicate half of the transition has completed.

The Hold Time output Field controls how long the transition bar should accept further changes. When the transition bar is clicked and dragged normally, the hold time is however long the mouse is dragging the transition bar before the mouse is released. But when using this input Action, OBS Studio has no idea how long the transition bar should be held down before resetting. This Field controls how long this input Action will hold the transition bar down. If no more updates to the transition bar are received within this time, the transition bar will be reset as if the mouse was released. This value is measured in milliseconds.

This input Action has some quirky behavior when used with a MIDI fader. When the fader is maxed out, OBS Studio will fully complete the scene transition, which invalidates the MIDI fader’s position. Be mindful of this if you would like to use a MIDI fader for this Action.

Custom Transition Settings

This input Action changes transition-specific properties of the selected transition (if applicable).

Output Fields are determined by the transition, and it is assumed that you know what each Field represents within the transition. Only Fields that the plugin is allowed to modify are displayed.


Output Mode

Current Transition Changed

This output Action occurs when the current transition (and/or its duration) is changed.

The Transition input Field controls what transition to listen for. This will show all available transitions that OBS Studio is using. This can optionally be ignored to listen only for the transition duration to change, as described below.

The Duration input Field controls what transition duration to listen for. This value is measured in milliseconds (ms). The Cut transition does not utilize this Field. This can optionally be ignored to listen only for the transition to change, as described above.

Transition Bar Moved

This output Action occurs when the transition bar changes by any means.

This Action will only work properly when Studio Mode is enabled.

The Position input Field controls the position of the current transition to listen for. This is measured in a 0-1024 scale, with 0 indicating the transition has not started, and 1024 indicating the new scene is fully showing. A value of 512, for example, would indicate half of the transition has completed.

Custom Transition Settings Changed

This output Action occurs when transition-specific properties of the selected transition change.

Input Fields are determined by the transition, and it is assumed that you know what each Field represents within the transition. Only Fields that the plugin is allowed to modify are displayed.

Use the Ignored Field mode to exclude the properties that you don’t use. Output Actions require that ALL input Fields be fulfilled, so if one property unrelated to your output Action may possibly change, you won’t have to change your output Action every time. This also applies to the complementary input Action!


Users of the plugin before version 3 may notice that some of the Actions within this category have been removed and replaced with None Actions. This is because of the complexity and limited use case for these Actions. If you really need to use MIDI as a means to control these parameters, the Advanced Scene Switcher plugin is highly recommended to serve this use case.


This site uses Just the Docs, a documentation theme for Jekyll.