Rebind

OBS Stream Deck Controller

@rebind / obs-scene-switcherv0.1.4Public

Hotkey control for OBS scenes, audio mute, streaming, recording, and camera via built-in OBS WebSocket.

Files

Older release. Installs get 0.1.4.

README.md2.1 KB

# OBS Stream Deck Controller

Turn any keyboard or mouse into a dedicated OBS Stream Deck. Switch scenes, mute audio inputs, toggle streaming/recording, save replay buffers, and toggle virtual camera directly through OBS Studio's built-in WebSocket server.

## Features

- **Direct OBS WebSocket v5 Connection**: Connects directly to OBS Studio without any third-party plugins, intermediate relays, or external Python/Node scripts.
- **Scene Switching**: Dedicated hotkeys for up to 5 custom scene names.
- **Audio Controls**: One-touch microphone mute/unmute.
- **Output Toggles**: Start/stop streaming and recording, or trigger instant replay buffer saves.
- **Virtual Camera**: Quick toggle for OBS Virtual Camera.
- **Authentication Support**: Works seamlessly whether password protection is enabled or disabled.
- **Auto-Reconnect**: Automatically reconnects if OBS is launched or restarted while the script is active.
- **Audio Feedback**: Optional chime confirmation on completed commands.
- **Configurable UI**: Adjust all hotkeys, scene names, source names, and connection settings directly in Rebind's Options tab without touching code.

## Setup in OBS Studio

1. Open **OBS Studio** (v28.0 or newer).
2. Go to **Tools** → **WebSocket Server Settings**.
3. Check **Enable WebSocket server**.
4. Note the **Server Port** (default is `4455`).
5. (Optional) If you enable authentication, copy the password and paste it into the **Server Password** field in Rebind's Options tab.
6. Click **Apply** and **OK**.

## Default Hotkeys

| Action | Default Key | Config Tab |
|---|---|---|
| Scene A | `Mouse4` | Scenes |
| Scene B | `Mouse5` | Scenes |
| Scene C | `F1` | Scenes |
| Scene D | `F2` | Scenes |
| Scene E | `F3` | Scenes |
| Toggle Mic Mute | `F9` | Controls |
| Start Stream | `F5` | Controls |
| Stop Stream | `F6` | Controls |
| Toggle Stream | `F10` | Controls |
| Toggle Record | `F11` | Controls |
| Save Replay Buffer | `F8` | Controls |
| Toggle Virtual Camera | `F7` | Controls |

All keybindings and scene names can be customized under the script's Options tab.

3 files, 9.2 KB.