# MIDI commands

Whatever Songstead sends to your devices is a list of MIDI commands, sent in order. You build the list once, and an outbound trigger, a remote control, or an inbound trigger's **Send MIDI Command** action sends it.

> [!PLAN] Backstage
> MIDI needs Backstage.

## Custom and saved commands

Wherever you choose what to send, there are two tabs:

- **Custom** is a list of commands that belongs to that one trigger or control. Select **Edit Custom Command** to build it.
- **Saved** picks a saved command by name. Select **Edit Saved Command** to change it, or **Create New** to make one without leaving the trigger.

A saved command lets you describe a patch once and send it from as many songs and buttons as you like. Changing a saved command changes it everywhere it's used.

## The Saved tab

The **Saved** tab on the **MIDI** page lists your saved commands.

![The Saved Commands card, with an Add Command button at the top right. It lists Clean tone, Crunch, Lead boost, Big room, Vocal reverb on and Footswitch A, each with the MIDI commands it sends and what uses it, such as Clean tone sending Program Change 0 on channel 1 to Amp Modeler, used by 2 outbound triggers and 1 Remote control.](https://songstead.app/docs/midi-commands/saved.webp)

Select **Add Command** to make a saved command, or select a row to edit one.

To delete a saved command, open it and select **Delete**, then **Yes, Delete**. You can only delete one that nothing uses.

## Build the list

1. Select **Add Command**. The command's fields open under the list.
2. Choose the kind of **Command**, then fill in the rest of its fields, or select **Listen** and send it from your device.
3. Select **Add**.
4. Add more commands the same way. Drag a row by its grip to change the order.
5. Select **Save**, or **Add** for a new saved command.

![The Edit Saved Command dialog for Big room. Its list has three commands: Program Change 3 on channel 1 to Amp Modeler, CC 91 = 100 on channel 2 to Vocal FX, and CC 81 = 127 on channel 2 to Vocal FX after a 50 ms wait. The second command is open under the list, showing Command, Channel, Controller, Listen, Value, To and Wait before (ms), with Remove, Cancel and Done. Below are Add Command and Test, a note that it's used by 1 outbound trigger and 1 Remote control, and Delete, Cancel and Save.](https://songstead.app/docs/midi-commands/editor.webp)

Select a command in the list to change or remove it. **Test** sends the whole list straight away, so you can hear the result before you save.

## A command's fields

| Field                             | What it's for                                                                                                                          |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Command                           | The kind of MIDI command. See the table below.                                                                                         |
| Channel                           | The MIDI channel, 1 to 16.                                                                                                             |
| Note, Controller, Program or Song | The number the command carries, 0 to 127. You can type a note by its name, like C4.                                                    |
| Velocity, Value or Bend           | How hard a note is played, what a controller is set to (0 to 127), or how far a Pitch Bend goes (−8192 to 8191).                       |
| Bank MSB, Bank LSB                | For a Program Change, an optional bank, sent as Control Change 0 and Control Change 32 before the Program Change.                     |
| Hex                               | For **Raw Bytes**, the bytes to send, written in hex, like `F0 7E 7F 06 01 F7`. They must be whole MIDI messages: a status byte, then its data bytes.                                                |
| To                                | The device it goes to, or **All devices**.                                                                                             |
| Wait before (ms)                  | How long to wait, in milliseconds, before sending this command.                                                                        |

Numbers start from 0, the way they're sent. Many devices count programs from 1, so a patch your device calls 1 is usually Program 0 here. Channels count from 1.

### Kinds of command

| Command        | What it sends                                                                               |
| -------------- | ------------------------------------------------------------------------------------------- |
| Note On        | A note starting, with its velocity.                                                         |
| Note Off       | A note ending.                                                                              |
| Control Change | A controller set to a value: an effect on or off, a volume, an expression pedal's position. |
| Program Change | A patch, preset or scene change.                                                            |
| Pitch Bend     | The pitch wheel's position.                                                                 |
| Song Select    | A song number, for sequencers and drum machines that store songs.                           |
| Start          | Starts a sequencer or drum machine from the top.                                            |
| Continue       | Starts it again from where it stopped.                                                      |
| Stop           | Stops it.                                                                                   |
| Raw Bytes      | Any bytes you type, such as System Exclusive messages.                                      |

## Listen

**Listen** fills in a command's fields from the next message one of your devices sends. Pick a patch on your keyboard or press a switch, and Songstead fills in the kind, channel, number and value. It's the surest way to get the channel and number right.

## Where commands go

**To** sends a command to one device, or to **All devices**.

- A command for one device only goes to that device, even when several devices share a channel.
- If that device isn't connected, Songstead tells you the command failed to send.
- A command for **All devices** with nothing connected isn't sent, so you can practice without your rig.
