OBS Source Transform

Runs on: Backend — reads transform data from the backend's OBS WebSocket bridge.

The OBS Source Transform node queries OBS for a specific transform property of a source inside a given scene and outputs the current value. Select the scene and source from the dropdowns — or wire string values into the Scene Name and Source Name handles — then choose which transform property to read.

The output type adjusts based on the selected property: most properties (position, scale, rotation, crop, bounds dimensions, and alignment) output a number. The Bounds Type property outputs a string. This is the read counterpart to the OBS Set Source Transform effect, making it easy to read a current value before computing an updated one.

Inputs

Name	Type	Description
sceneName	string	The OBS scene that contains the source. Overrides the dropdown when connected.
sourceName	string	The source within the scene to read from. Overrides the dropdown when connected.

Outputs

Name	Type	Description
output	number or string	The current value of the selected transform property.

Configuration

• Scene: Dropdown listing your OBS scenes. Used when Scene Name is not wired.
• Source: Dropdown listing all sources in OBS. Used when Source Name is not wired.
• Property: Which transform value to read — Position X/Y, Rotation, Scale X/Y, Crop Top/Bottom/Left/Right, Bounds Type, Bounds Width/Height, Bounds Alignment, or Alignment.

Example

An animation flow reads the current X position of a source using OBS Source Transform, adds a delta value with a Math node, and feeds the result back into an OBS Set Source Transform effect. This creates a smooth incremental repositioning effect each time the flow runs, driven entirely by the source's own live position.