MIDI and keyboard mapping

Driving LMX from a MIDI surface or from mapped keyboard keys.

LMX can be driven from a MIDI control surface or from keys you choose. Both use the MAP command, and both have a page in the Config window under External control.

Opening a MIDI device

LIST MIDI                       # devices LMX can see
CONFIG MIDI "APC mini mk2"      # open it
CONFIG MIDI "APC mini mk2" REMOVE
DEBUG MIDI                      # print incoming messages

DEBUG MIDI is the fast way to find out what a control actually sends - channel, type and number - before you map it.

Mapping a MIDI control

MAP MIDI "<device>" <channel> [CC|NOTE] <number> TO <action> [FEEDBACK …]
MAP MIDI "<device>" <channel> [CC|NOTE] <number> REMOVE

A bare <number> means CC; write CC or NOTE to be explicit. A NOTE mapping triggers on note-on velocity - note-off, and velocity 0, both mean 0.

Actions

`TO …`	Does
`FADER <n>` or `FADER <page>.<n>`	Drive a fader
`GO [<cuelist>]`	Fire the next cue
`FLASH <n>\|<page>.<n>` [`LATCH`]	Flash a fader; `LATCH` makes it a toggle
`INTENSITY` · `PAN` · `TILT`	Drive that attribute on the current selection
`PAN_FAN` · `TILT_FAN`	Drive the fan spread on the current selection
`TAP FREQUENCY <id>`	Tap tempo - see Frequency masters
`COMMAND "<text>"`	Run any command at all

COMMAND is the escape hatch: anything you can type, a pad can fire.

Feedback

… TO FLASH 3 FEEDBACK
… TO FLASH 3 FEEDBACK 1 40
… TO FLASH 3 FEEDBACK NOTE 1 40

Sends the state back to the surface so its LEDs follow LMX. FEEDBACK with no arguments echoes on the same type, channel and number as the trigger; add a channel and number to send it somewhere else.

Detect instead of typing

MAP MIDI DETECT TO FADER 5

A small window waits for you to touch a control on an open MIDI input, then uses its device, channel, type and number. Far quicker than reading the manual, and it cannot get the numbers wrong.

Mapping a key

MAP KEY [CTRL] [ALT] [SHIFT] <key> GO [<cuelist>]
MAP KEY [CTRL] [ALT] [SHIFT] <key> STOP [<cuelist>]
MAP KEY [CTRL] [ALT] [SHIFT] <key> COMMAND "<text>" [ENTER]
MAP KEY [CTRL] [ALT] [SHIFT] <key> TAP FREQUENCY <id>
MAP KEY [CTRL] [ALT] [SHIFT] <key> REMOVE
MAP KEY DETECT …

COMMAND "<text>" puts the text in the command line; add ENTER to run it immediately. Without ENTER it is a prefix you finish typing - handy for GO or FIXTURE .

Which keys can be mapped

Any key: single characters, F1–F12, the numpad (NUM0–NUM9, NUM+, NUM-, NUM*, NUM/, NUM., NUMENTER), and the named keys HOME END PGUP PGDN UP DOWN LEFT RIGHT INSERT DELETE ENTER TAB BACKSPACE SPACE ESC.

Bare (no modifier) is allowed for: F1–F12, every numpad key, and HOME END PGUP PGDN INSERT DELETE TAB ESC.

Everything else needs CTRL or ALT - characters, arrows, ENTER, BACKSPACE, SPACE. That rule exists so ordinary typing and field navigation can never be hijacked by a mapping.

MAP KEY DETECT waits for you to press the combination and refuses one it cannot map, without closing.

Seeing and removing mappings

SHOW MAP                        # every mapping
MAP MIDI "APC mini" 1 CC 7 REMOVE
MAP KEY CTRL G REMOVE

The Config window’s External control page lists MIDI and keyboard mappings in two tables, with Add / Edit / Remove for each.

A worked surface

CONFIG MIDI "APC mini mk2"
MAP MIDI "APC mini mk2" 1 CC 48 TO FADER 1.1
MAP MIDI "APC mini mk2" 1 CC 49 TO FADER 1.2
MAP MIDI "APC mini mk2" 1 NOTE 0 TO FLASH 1.1 LATCH FEEDBACK
MAP MIDI "APC mini mk2" 1 NOTE 98 TO GO
MAP MIDI "APC mini mk2" 1 NOTE 82 TO COMMAND "STOP FADE 3"
MAP KEY NUM0 GO
MAP KEY NUMENTER STOP
SHOW MAP