Midi2Macro

OBS MIDI Hotkeys: Control Your Stream with a MIDI Controller

OBS MIDI Hotkeys: Control Your Stream with a MIDI Controller

Streaming requires a continuous sequence of small, time-critical actions. Switch your scene. Mute your microphone before you cough. Show the "be right back" overlay. Start or stop the stream. You can do all of this in OBS via keyboard shortcuts, but they can be tricky to remember, especially if your hands are already busy playing a game, the guitar, or petting your cat.

A physical controller gives each of those actions its own tactile button. You press the button and the action happens - without having to look for a key combination mid-stream.

Streamer's desk with a Novation Launchpad Mini next to the keyboard and OBS open on the monitor
A small pad controller sitting where you can reach it without looking.

How it works

Midi2Macro runs in the background and listens for inputs from your MIDI controller. When you press a key or a pad, it fires the keyboard shortuct you assigned to it in Midi2Macro. OBS reacts exactly as if you had typed the shortcut yourself. Nothing to install inside OBS, no plugins, no scripting. The delay between the press and the scene change is far below anything you would notice on stream.

Hotkeys worth mapping first

If you stream regularly, there's a handful of actions you likely use often. The key combinations below are of course just examples. The real ones are whatever you assign in OBS under Settings → Hotkeys.

ActionCommon shortcut
Scene 1 (main)Ctrl+F1
Scene 2 (camera)Ctrl+F2
Scene 3 (BRB)Ctrl+F3
Start/stop recordingCtrl+Shift+R
Start/stop streamingCtrl+Shift+S
Mute micCtrl+Shift+M
Push to talkSpace
Studio mode transitionCtrl+T

OBS ships with these unassigned, so you have to set them up yourself. It's usually easiest if you pick a pattern you can remember easily and keep it consistent across scenes.

OBS Studio Settings Hotkeys panel with shortcuts assigned to scene switches and recording
OBS hotkey assignments. Match these in Midi2Macro and the mapping is done.

Setup, start to finish

  1. In OBS, open Settings → Hotkeys and assign keyboard shortcuts to the actions you want to control.

  2. Plug in your MIDI controller. Most are USB class-compliant and need no drivers.

  3. Open Midi2Macro. The app detects and shows your controller in the device list automatically.

  4. Press a key or a pad. Midi2Macro displays the incoming note.

  5. Pick Trigger Shortcut as the action, record the same combination you set in OBS, and save.

  6. Switch back to OBS and press the pad. The scene changes.

Midi2Macro showing Launchpad pads mapped to Trigger Shortcut actions with Ctrl + Alt + Shift key combinations for OBS
Launchpad pads mapped to the OBS hotkeys with Trigger Shortcut actions.

Skip the hotkeys: native OBS control in Midi2Macro 2.0

If you would rather not manage a second set of shortcuts inside OBS, Midi2Macro 2.0 connects to OBS directly over its WebSocket server. Instead of sending a keystroke, Midi2Macro tells OBS what to do: switch to a named scene, start or stop recording, toggle the virtual camera, show or hide a source, mute an input. You select the scene or source from a dropdown, so there is no shortcut to assign or remember on the OBS side.

Midi2Macro OBS Action editor with Switch Scene selected and a scene chosen from the dropdown
A native OBS Switch Scene action, configured without touching OBS hotkeys.

The hotkey method still has its place. It works with anything OBS can bind a shortcut to, including plugins and features that have no WebSocket equivalent. Many streamers mix the two: native actions for the common scene and recording controls and then use hotkeys for the edge cases.

Midi2Macro listing Launchpad pads and faders mapped to native OBS actions for recording, scene switching, scene items and input volume
A Launchpad set up with native OBS actions: recording, scene switches, scene items and input volume.

Volume and faders

Most OBS macros are discrete actions: switch a scene, toggle mute, start a recording. Midi2Macro 2.0 added full support for CC (Control Change) messages, so you can now assign macros to knobs, faders and control buttons as well as keys and pads. You can read more about it in what's new in Midi2Macro 2.0.

While support for continuous use of the CC Value parameter is limited at this time, you can hook it up to control the Input Volume of your audio devices directly within OBS. This way a physical fader can ride your mic or music volume in real time.

For one-off macros, a key or pad is still the recommended option.

Hand resting on the faders of a Novation Launchkey MIDI keyboard under blue light
Riding a fader on the Launchkey to set an OBS audio level.
Midi2Macro Set Input Volume action mapped to a CC fader for live OBS audio control
A fader's CC value driving an OBS input level through the Set Input Volume action.
OBS Audio Mixer showing Desktop Audio and Mic/Aux volume sliders set by a MIDI fader
The result in the OBS Audio Mixer: Desktop Audio and Mic/Aux levels follow the faders.

Per-app profiles in version 2.0

If you stream and edit your videos on the same machine, Midi2Macro 2.0 offers per-app profiles that can help simplify your setup. You can build one profile for OBS and another one for your editor and Midi2Macro switches to the correct one based on which app is in focus. While in OBS your pads drive your scenes. While in DaVinci Resolve the same pads handle split, mark in, and mark out.

What you need

A MIDI controller with a USB output. Both the Novation Launchpad and Launchkey work great - and they are the devices I mainly use, but you can also use controllers such as the Akai MPK Mini, an LPD8, or any other MIDI keyboard you already own.

Midi2Macro is free for up to 5 macros, and the Pro version is a one-time $20 USD.

Download and try Midi2Macro for free here