This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

MIDI

    The MIDI remote control lets you control mAirList with any MIDI device, e.g. a MIDI keyboard or a DJ controller. Incoming MIDI messages are mapped to remote control commands.

    Configuration

    In the configuration app or Control Panel, go to Remote Control and add an interface of type MIDI (Generic category).

    General

    On the General tab, select the MIDI input Device that mAirList should listen to.

    The Monitor helps you to find out which messages your MIDI device sends. Check Enable Monitor, then press a button or move a fader on your device. The received messages will be displayed in the list, with their status/channel byte, Data1 and Data2 values (decimal and hexadecimal). Double-click a message to add it to the command list.

    Commands

    The Commands tab contains the list of MIDI messages that mAirList will react to, along with the command to execute. Use the toolbar to add, edit, or remove entries.

    Each entry consists of the following settings:

    • Status/Channel: The MIDI status byte, which contains both the message type and the MIDI channel, e.g. 144 (90 hex) for a Note On message on channel 1.
    • Data1: The first data byte, e.g. the note or controller number.
    • Data2 Condition and Data2 Value: A condition for the second data byte (e.g. the velocity or controller value). Choose one of =, !=, <, <=, >=, > to compare the received value against the Data2 Value, or * to match any value.
    • Command: The remote control command to execute when a matching message is received.

    The variable $DATA2 in the command will be replaced by the actual Data2 value of the received message (0 to 127). This way, a single entry with the * condition can pass the position of a fader or rotary control on to a command.

    SYSEX messages are not supported for commands.

    Scripting

    MIDI messages can also be processed by background scripts, using the OnMidiMessage and OnMidiSysex event handlers. Scripts can also send MIDI messages, e.g. to control the LEDs of a MIDI controller: Open the output device with MidiOutOpen, then use MidiOut and MidiOutSysEx to send messages. MidiOutListDevices writes the list of available output devices to the System Log.