OBS Studio Actions
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's settings (go to Settings → Integrations → OBS Studio)
Quick Start
- Open OBS Studio and enable the WebSocket server (Tools → WebSocket Server Settings).
- In TipLink, go to Settings → Integrations → OBS Studio and connect your OBS instance.
- 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 six 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. |
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.