OBS Studio Actions
Created 19 Mar 2026·Updated 11 Sept 2026
TipLink can send commands directly to OBS Studio, letting you switch scenes, show or hide sources, toggle filters, and start/stop recording or streaming - all triggered by stream events.
What You Need
- OBS Studio installed and running on your PC
- The OBS WebSocket server enabled in OBS (go to Tools → WebSocket Server Settings and turn it on)
- An OBS account connected in TipLink (go to the Platforms page and add OBS Studio)
Quick Start
- Open OBS Studio and enable the WebSocket server (Tools → WebSocket Server Settings).
- In TipLink, open the Platforms page, add OBS Studio, then connect it.
- Create or edit an alert.
- Click Add Action and select the OBS action you want.
- Choose your OBS Account from the dropdown, then fill in the remaining options.
- Save and test using the Test Event Tool.
Available OBS Actions
TipLink supports eight OBS action types, all found under the OBS Studio category when adding an action.
OBS: Switch Scene
Switch OBS to a specific scene when the alert fires.
Configuration Options
| Setting | Description | Default |
|---|---|---|
| OBS Account | The connected OBS instance to control. | - |
| Scene Name | The scene to switch to (populated from your connected OBS). | - |
| Only Switch From Authorized Scenes | When enabled, TipLink will only switch if OBS is currently on one of the authorized scenes listed below. | Off |
| Authorized Scenes | (Visible when the above toggle is on) - a list of scenes that OBS must be on for the switch to happen. | - |
Authorized Scenes is useful for safety - for example, only allowing a scene switch if you're on your "Live" scene, preventing accidental switches while you're on a BRB or Starting Soon screen.
OBS: Set Source Visibility
Show or hide a specific source within a scene.
Configuration Options
| Setting | Description | Default |
|---|---|---|
| OBS Account | The connected OBS instance to control. | - |
| Scene Name | The scene that contains the source. | - |
| Source Name | The source to show or hide (populated after selecting a scene). | - |
| Set Visible | Toggle: On = show the source, Off = hide the source. | On |
You can use this to reveal a "Hype" overlay element when a donation comes in, or hide a countdown timer source when it reaches zero.
OBS: Set Filter Visibility
Enable or disable a filter applied to any source.
Configuration Options
| Setting | Description | Default |
|---|---|---|
| OBS Account | The connected OBS instance to control. | - |
| Source Name | The name of the source that has the filter applied (type it manually). | - |
| Filter Name | The exact name of the filter (type it manually, case-sensitive). | - |
| Set Visible | Toggle: On = enable the filter, Off = disable it. | On |
Source and filter names must be entered manually and match exactly what appears in OBS (including capitalisation).
OBS: Start Recording
Start recording in OBS.
Configuration Options
| Setting | Description |
|---|---|
| OBS Account | The connected OBS instance to control. |
No additional options - just select your OBS account and the action will start recording when the alert fires.
OBS: Stop Recording
Stop recording in OBS.
Configuration Options
| Setting | Description |
|---|---|
| OBS Account | The connected OBS instance to control. |
OBS: Start Streaming
Start streaming in OBS.
Configuration Options
| Setting | Description |
|---|---|
| OBS Account | The connected OBS instance to control. |
OBS: Stop Streaming
Stop streaming in OBS.
Configuration Options
| Setting | Description |
|---|---|
| OBS Account | The connected OBS instance to control. |
Be careful about which alert you attach this to. Anything a viewer can trigger, such as a chat command or a channel point redemption, could take you off air.
OBS: Add Chapter Marker
Drop a chapter marker into the recording you are currently making, so you can jump straight to the good bits when you edit later.
Configuration Options
| Setting | Description | Default |
|---|---|---|
| OBS Account | The connected OBS instance to control. | - |
| Chapter Name | An optional name for the chapter. Accepts placeholders, so {{ username }} names it after whoever triggered it. Leave blank to let OBS name it. | Blank |
| Skip If Not Recording | When on, the action does nothing if you are not recording, instead of reporting a failure. | - |
Chapter markers need OBS Studio 30.2 or newer, and your recording must be in Hybrid MP4 format. Other formats do not support chapters, and the action will fail.
Common uses
Mark every big tip
- Trigger: Tip, with a minimum amount
- Chapter Name:
{{ username }} tipped {{ value }}
You end up with a recording whose chapter list is a highlight reel.
Mark raids and hype moments
- Trigger: Received a Raid
- Chapter Name:
Raid from {{ username }}
Tips
- Scene switching with authorization - use the Authorized Scenes list to make scene switches safe. For example, only switch to "Hype Cam" if you're currently on "Main" or "Just Chatting", not while you're already on a BRB screen.
- Combine with Show/Hide Widget - pair an OBS scene switch with a Show Overlay Widget action to update your TipLink overlay at the same time.
- Test without going live - use the Test Event Tool to verify your OBS actions are working before your stream.
- Filter control use cases - toggle a blur filter on your face cam during game-over screens, or enable a glitch effect filter when a raid comes in.