> For the complete documentation index, see [llms.txt](https://standalone-audio.gitbook.io/standalone-audio-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://standalone-audio.gitbook.io/standalone-audio-docs/midi-beta.md).

# MIDI (Beta)

1. Open Settings (Cmd+,)
2. Scroll to the MIDI section
3. Toggle "Enable MIDI" on (defaults on)
4. Select your MIDI controller from the **Input** dropdown
   * Choose "All Inputs" to receive from any connected device
   * Or select a specific controller
5. Set **Channel** to Omni or a specific channel (1-16)

### Using MIDI with Plugins

1. Click the MIDI icon in the Modules panel (bottom right)
2. The Mapping Panel shows available host controls
3. To map a control:
   * Click **Learn** next to the control you want to map
   * Press the button/footswitch on your MIDI controller
   * The mapping is saved automatically
4. Or click the CC field and type a CC number manually
5. To remove a mapping, click the X next to it

**Note: Not all Plugins support MIDI** 

### Available Host Controls

| Control               | Type       | Description                          |
| --------------------- | ---------- | ------------------------------------ |
| Mute (Guitar)         | Toggle     | Mute/unmute the guitar signal        |
| Master Mute           | Toggle     | Mute/unmute all output               |
| Master Volume         | Continuous | Control the output volume            |
| Tuner Toggle          | Toggle     | Show/hide the tuner                  |
| Looper Record/Overdub | Momentary  | Start/stop loop recording            |
| Looper Clear          | Momentary  | Clear the current loop               |
| Tap Tempo             | Momentary  | Tap tempo for the metronome          |
| Preset Next           | Momentary  | Load the next preset                 |
| Preset Previous       | Momentary  | Load the previous preset             |
| Bypass Slot 1-8       | Toggle     | Bypass/enable a specific plugin slot |

### Preset Switching with Program Change

1. In Settings > MIDI, make sure "MIDI Program Change Loads Standalone Presets" is enabled (it's on by default)
2. Send a Program Change message from your controller
3. Presets are loaded in alphabetical order
4. When this setting is off, Program Change messages only affect plugins

**Note:** When this setting is on, Program Change messages will load a Standalone preset AND be forwarded to your plugins. If a plugin also responds to Program Change (e.g., Helix Native), both will change presets simultaneously. **This will be updated in the next version.**

### Tips

* If your pedalboard controls multiple devices, set a specific MIDI channel so Standalone only responds to messages intended for it
* Host MIDI mappings are saved globally — they persist across presets and app restarts
* The green dot next to MIDI in Settings pulses when MIDI messages are received — use this to verify your controller is connected

\ <br>