Docs / MIDI

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.

MIDI needs Backstage.

Requires 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.

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.

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

FieldWhat it's for
CommandThe kind of MIDI command. See the table below.
ChannelThe MIDI channel, 1 to 16.
Note, Controller, Program or SongThe number the command carries, 0 to 127. You can type a note by its name, like C4.
Velocity, Value or BendHow 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 LSBFor a Program Change, an optional bank, sent as Control Change 0 and Control Change 32 before the Program Change.
HexFor 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.
ToThe 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

CommandWhat it sends
Note OnA note starting, with its velocity.
Note OffA note ending.
Control ChangeA controller set to a value: an effect on or off, a volume, an expression pedal's position.
Program ChangeA patch, preset or scene change.
Pitch BendThe pitch wheel's position.
Song SelectA song number, for sequencers and drum machines that store songs.
StartStarts a sequencer or drum machine from the top.
ContinueStarts it again from where it stopped.
StopStops it.
Raw BytesAny 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.