OBS Stream Deck Controller

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

# OBS Stream Deck Controller

Turn any keyboard or mouse into an OBS stream deck. It talks to the WebSocket server built into OBS 28 and newer, with no plugins and nothing else to run: five scene keys, mic mute, stream and recording toggles, replay saves, and the virtual camera. It reconnects by itself if OBS restarts, and can chime when a command lands.

Needs Rebind 3.5.0 or newer on Windows or macOS, and OBS Studio 28 or newer. It requests network access to reach OBS.

## Set up

1. In OBS, open **Tools > WebSocket Server Settings** and check **Enable WebSocket server**. Note the port (4455 by default).
2. If you turn on authentication, copy the password into **Server Password** on the package's **Connection** tab.
3. Set your scene names and keys on the **Scenes** and **Controls** tabs, then start the package.

## Default keys

| Action | Key |
|---|---|
| Scene A / B / C / D / E | Mouse 4 / Mouse 5 / F1 / F2 / F3 |
| Mute or unmute the mic | F9 |
| Start / stop / toggle streaming | F5 / F6 / F10 |
| Toggle recording | F11 |
| Save the replay buffer | F8 |
| Toggle the virtual camera | F7 |

Every key and scene name is a setting. Key changes apply while the package runs on Rebind 3.9 or newer; on older versions, restart the package.

## Limits

- The keys work in every app, not only in OBS, and they no longer do their usual job anywhere while the package runs. Move them to keys you do not otherwise use.
- **Mic Source Name** must match the audio source's name in OBS, such as `Mic/Aux`.
- **Audio Feedback on Actions** plays a short tone on Rebind 3.9 or newer; older versions stay silent.
- Results show as notices in Rebind. To see them on the desktop, turn on **Desktop notifications** in Rebind's settings.
- Live use remains unverified on Windows and macOS.

## Stop

Stop the package from the editor toolbar, or press **Left Ctrl + Left Alt + K** (**Left Control + Left Option + K** on macOS) to stop all scripts. Stopping closes the connection to OBS.