Skip to content

MIDI Macros

A MIDI macro is a named, reusable command sequence. Define it once, then call it from any MIDI command field with a $ prefix instead of repeating the whole sequence in every song. When you later change the macro, every song that references it sends the new commands.

The list shows all defined macros with their code and description. Tap a macro to edit it, swipe left to delete it, or tap Add Macro to create a new one.

Tip

Macros are ideal for sequences you send from many songs, such as resetting all your effects, switching your amp to a clean channel, or recalling a standard patch layout.

Edit Macro

Code

The name you use to reference the macro. Codes are converted to uppercase as you type and must:

  • start with a letter
  • contain only letters, digits, _ and - after that
  • be at most 12 characters long
  • be unique across all macros

Examples of valid codes: FX-OFF, PATCH_1, CLEAN.

Note

Codes are case-insensitive. $fx-off and $FX-OFF reference the same macro.

Description

An optional comment describing what the macro does. It is only shown in the macro list to help you find the right macro later.

Command

The MIDI commands this macro sends, using the standard MIDI command syntax without the [midi: ...] tag wrapper. Separate multiple commands with commas — they are sent in the order written.

CC123.0@1, PC0@1, CC7.100@1

Tap Learn to capture commands from a connected device. Unlike the other MIDI fields, macro learn keeps listening and appends every command it receives, so you can record a complete sequence by playing it on your device in one pass.

Note

A macro cannot reference another macro. Macros are one level deep.

Using a Macro

Once defined, reference a macro as $CODE in any MIDI command field — lyrics tags, song MIDI triggers, the Send MIDI fields, and MIDI actions:

[midi: $FX-OFF]
[midi@play: PC1@5, $PATCH_1]

See Using Macros for details.