Beta reference. Prepared from development builds for this version. This reference does not describe the current stable release.

A verified stable reference is not available yet. Choose a prepared beta version above.

When · Triggers · supported

OBS scene change

Fires when OBS changes to a selected program scene. Leave the scene blank to react to any scene change.

trigger.obs_scene_change · 2.8.0

Requirements and availability

Connected supported event provider; enabled automation and matching filters.

Picker contexts: automation.

Incoming providers: obs.

Program-scene change; blank selects any scene, otherwise trimmed case-insensitive scene-name equality. Requires OBS connection.

Open: Bot → Automations → + New → When

Choose Trigger category: Broadcast software & installed apps.
Choose Trigger event: OBS scene change.
Fill the Trigger filters below, set Cooldown (seconds), then open Where and choose a supported Platform.
Open Do, add actions, then Create Automation or Save Changes.

Field	Input / options	Defaults / limits	Availability
Scene (blank = any scene) `sceneName`	obs_scene_dropdown		Trigger filter

Cooldown: Automation cooldownSec defaults 0; keyed by automation ID and event platform; held in memory until restart.
Delay: No additional trigger delay.

Trigger selection and filter defaults; supply a real target/pattern when required.

{
  "triggerType": "obs_scene_change",
  "triggerPlatform": "obs",
  "triggerFilters": {
    "sceneName": ""
  }
}

Source-reviewed for 2.8.0. Connected-service validation remains subject to release UAT.

src/features/automations.js — TRIGGER_REGISTRY.obs_scene_change
src/features/automation-provider-capabilities.js — AUTOMATION_TRIGGER_PLATFORMS.obs_scene_change

Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1