DOCSOBS WebSocket
Overlay control.
Connect OBS to the desktop app via WebSocket so your AI host can trigger scene switches, source toggles, and overlay alerts automatically.
Enable OBS WebSocket
Open OBS Studio. Tools → WebSocket Server Settings. Check Enable WebSocket server. Set a strong password. Note the server port (default 4455). Click Apply.
Connect from the desktop app
Open Integrations → OBS in the GRIMASA desktop app. Enter the WebSocket address (default localhost:4455), paste the password, click Connect. The app reads your scene list and source list.
Map event triggers
Open the Event Triggers panel. Pick a gift type (e.g. TikTok Rose) and add an action — Switch Scene, Toggle Source, Play Media. The host triggers it when the gift arrives during a stream, as reported by the platform.
Common patterns
- Big gift → switch to a celebration scene with confetti
- Subscriber → toggle a 'New Sub' source for 5 seconds, then off
- Topic-related question → switch to a topic-specific scene with relevant overlays