Connect any MIDI device via USB to control MaestroDMX’s Show Control Mode.
NOTE: MaestroDMX is a USB host similar to a PC. Therefore, if you want to send MIDI from another host, such as a PC running Ableton Live or Logic, you will need to connect 2 USB-to-MIDI dongles. In the following configuration:
PC → USB → Dongle 1:MIDI OUT--(female to female midi coupler)-- Dongle 2:MIDI IN → USB → MaestroDMX
Purchase on Amazon: 2 X Midi Dongle and 1 X Midi Coupler
For a regular MIDI device such as a keyboard or control pad, simply connect it to MaestroDMX with a USB cable.
NOTE: MIDI messages for the Trigger Buttons (Blackout, Blinder, Strobe, etc.) function either as momentary or latching. Meaning that they will not respect the latching mode that is selected on the MaestroDMX Web App. Please use the appropriate latching or momentary version of the trigger MIDI message as needed
Action (NOTE ON) | Key Number | Hex Value | Note* | Ch |
Effect 0 (Momentary) – built-in Effect button | 0 | 0x00 | C-2 to C0 | 16 |
Effect 1 (Momentary) | 1 | 0x01 | C#-2 to C#0 | 16 |
Effect 2 (Momentary) | 2 | 0x02 | D-2 to D0 | 16 |
Effect 3 (Momentary) | 3 | 0x03 | D#-2 to D#0 | 16 |
Effect 4 (Momentary) | 4 | 0x04 | E-2 to E0 | 16 |
Effect 5 (Momentary) | 5 | 0x05 | F-2 to F0 | 16 |
Effect 6 (Momentary) | 6 | 0x06 | F#-2 to F#0 | 16 |
Effect 7 (Momentary) | 7 | 0x07 | G-2 to G0 | 16 |
Play/Pause | 11 | 0x0B | B-2 to B0 | 16 |
Strobe (Toggle) | 12 | 0x0C | C-1 to C1 | 16 |
Blackout (Toggle) | 13 | 0x0D | C#-1 to C#1 | 16 |
Blinder (Toggle) | 14 | 0x0E | D-1 to D1 | 16 |
Fog (Toggle) | 15 | 0x0F | D#-1 to D#1 | 16 |
Effect (Toggle) – Effect 0 | 16 | 0x10 | E-1 to E1 | 16 |
Load Previous Show | 17 | 0x11 | F-1 to F1 | 16 |
Load Next Show | 18 | 0x12 | F#-1 to F#1 | 16 |
Blackout (Momentary) | 19 | 0x13 | G-1 to G1 | 16 |
Blinder (Momentary) | 20 | 0x14 | G#-1 to G#1 | 16 |
Strobe (Momentary) | 21 | 0x15 | A-1 to A1 | 16 |
Fog (Momentary) | 22 | 0x16 | A#-1 to A#1 | 16 |
Effect (Momentary) – legacy alias of Effect 0 (key 0) | 23 | 0x17 | B-1 to B1 | 16 |
Previous Cue | 24 | 0x18 | C0 to C2 | 16 |
Next Cue | 25 | 0x19 | C#0 to C#2 | 16 |
Play | 26 | 0x1A | D0 to D2 | 16 |
Pause | 27 | 0x1B | D#0 to D#2 | 16 |
Stop | 28 | 0x1C | E0 to E2 | 16 |
Select Cue 1 – 99 | 29 – 127 | 0x1D – 0x7F | F0 to F2 (Cue 1) … G8 to G10 (Cue 99) | 16 |
|
|
|
|
|
NOTES |
* The note name for a key number depends on the manufacturer's octave convention. Each range runs from the Middle C = C3 convention (Yamaha, Ableton) through Middle C = C4 (Roland, scientific pitch) to Middle C = C5. Match on Key Number, and transpose your controller if needed. |
Toggle actions fire on NOTE ON and latch until the next NOTE ON. They ignore the latching mode selected in the MaestroDMX web app. |
Momentary actions turn on with NOTE ON (velocity 1 – 127) and turn off with NOTE OFF or NOTE ON with velocity 0. |
Effects are numbered 0 – 7 (the same numbering as OSC). Effect 0 is the built-in Effect button. Sending a number with no button assigned does nothing. Effects 1 – 7 are momentary-only over MIDI; only Effect 0 has a toggle (key 16). To toggle effects 1 – 7, use OSC (/triggers/effect/E/toggle). |
Select Cue: key 29 starts the first cue of the loaded show, key 30 the second, and so on up to key 127 (cue 99). |
Key numbers 8 – 10 are unassigned. MaestroDMX v1.6 listens on MIDI channel 16. |
Action (on CONTROL CHANGE) | CC Number | Hex Value | Ch |
Show Select | 0 | 0x00 | 16 |
Global Brightness | 14 | 0x0E | 16 |
Trigger: Strobe Rate | 15 | 0x0F | 16 |
Trigger: Strobe Brightness | 16 | 0x10 | 16 |
Trigger: Blinder Brightness | 17 | 0x11 | 16 |
Trigger: Fog Volume | 18 | 0x12 | 16 |
Trigger: Fog Duration | 19 | 0x13 | 16 |
Trigger: Fog Interval | 20 | 0x14 | 16 |
Trigger: Fog Speed | 21 | 0x15 | 16 |
Fader 0 | 22 | 0x16 | 16 |
Fader 1 | 23 | 0x17 | 16 |
Fader 2 | 24 | 0x18 | 16 |
Fader 3 | 25 | 0x19 | 16 |
Fader 4 | 26 | 0x1A | 16 |
Fader 5 | 27 | 0x1B | 16 |
Fader 6 | 28 | 0x1C | 16 |
Fader 7 | 29 | 0x1D | 16 |
Zone 1: Brightness | 30 | 0x1E | 16 |
Zone 1: Excitement | 31 | 0x1F | 16 |
Zone 1: Background | 32 | 0x20 | 16 |
Zone 1: Mover Range | 33 | 0x21 | 16 |
Zone 1: Mover Speed | 34 | 0x22 | 16 |
Zone 1: Pattern | 35 | 0x23 | 16 |
Zone 1: Colour Palette | 36 | 0x24 | 16 |
Zone 1: FX Palette | 37 | 0x25 | 16 |
Zone 2: Brightness | 40 | 0x28 | 16 |
Zone 2: Excitement | 41 | 0x29 | 16 |
Zone 2: Background | 42 | 0x2A | 16 |
Zone 2: Mover Range | 43 | 0x2B | 16 |
Zone 2: Mover Speed | 44 | 0x2C | 16 |
Zone 2: Pattern | 45 | 0x2D | 16 |
Zone 2: Colour Palette | 46 | 0x2E | 16 |
Zone 2: FX Palette | 47 | 0x2F | 16 |
Zone 3: Brightness | 50 | 0x32 | 16 |
Zone 3: Excitement | 51 | 0x33 | 16 |
Zone 3: Background | 52 | 0x34 | 16 |
Zone 3: Mover Range | 53 | 0x35 | 16 |
Zone 3: Mover Speed | 54 | 0x36 | 16 |
Zone 3: Pattern | 55 | 0x37 | 16 |
Zone 3: Colour Palette | 56 | 0x38 | 16 |
Zone 3: FX Palette | 57 | 0x39 | 16 |
Zone 4: Brightness | 60 | 0x3C | 16 |
Zone 4: Excitement | 61 | 0x3D | 16 |
Zone 4: Background | 62 | 0x3E | 16 |
Zone 4: Mover Range | 63 | 0x3F | 16 |
Zone 4: Mover Speed | 64 | 0x40 | 16 |
Zone 4: Pattern | 65 | 0x41 | 16 |
Zone 4: Colour Palette | 66 | 0x42 | 16 |
Zone 4: FX Palette | 67 | 0x43 | 16 |
Zone 5: Brightness | 70 | 0x46 | 16 |
Zone 5: Excitement | 71 | 0x47 | 16 |
Zone 5: Background | 72 | 0x48 | 16 |
Zone 5: Mover Range | 73 | 0x49 | 16 |
Zone 5: Mover Speed | 74 | 0x4A | 16 |
Zone 5: Pattern | 75 | 0x4B | 16 |
Zone 5: Colour Palette | 76 | 0x4C | 16 |
Zone 5: FX Palette | 77 | 0x4D | 16 |
Zone 6: Brightness | 80 | 0x50 | 16 |
Zone 6: Excitement | 81 | 0x51 | 16 |
Zone 6: Background | 82 | 0x52 | 16 |
Zone 6: Mover Range | 83 | 0x53 | 16 |
Zone 6: Mover Speed | 84 | 0x54 | 16 |
Zone 6: Pattern | 85 | 0x55 | 16 |
Zone 6: Colour Palette | 86 | 0x56 | 16 |
Zone 6: FX Palette | 87 | 0x57 | 16 |
Zone 7: Brightness | 90 | 0x5A | 16 |
Zone 7: Excitement | 91 | 0x5B | 16 |
Zone 7: Background | 92 | 0x5C | 16 |
Zone 7: Mover Range | 93 | 0x5D | 16 |
Zone 7: Mover Speed | 94 | 0x5E | 16 |
Zone 7: Pattern | 95 | 0x5F | 16 |
Zone 7: Colour Palette | 96 | 0x60 | 16 |
Zone 7: FX Palette | 97 | 0x61 | 16 |
Zone 8: Brightness | 100 | 0x64 | 16 |
Zone 8: Excitement | 101 | 0x65 | 16 |
Zone 8: Background | 102 | 0x66 | 16 |
Zone 8: Mover Range | 103 | 0x67 | 16 |
Zone 8: Mover Speed | 104 | 0x68 | 16 |
Zone 8: Pattern | 105 | 0x69 | 16 |
Zone 8: Colour Palette | 106 | 0x6A | 16 |
Zone 8: FX Palette | 107 | 0x6B | 16 |
Zone 9: Brightness | 110 | 0x6E | 16 |
Zone 9: Excitement | 111 | 0x6F | 16 |
Zone 9: Background | 112 | 0x70 | 16 |
Zone 9: Mover Range | 113 | 0x71 | 16 |
Zone 9: Mover Speed | 114 | 0x72 | 16 |
Zone 9: Pattern | 115 | 0x73 | 16 |
Zone 9: Colour Palette | 116 | 0x74 | 16 |
Zone 9: FX Palette | 117 | 0x75 | 16 |
Zone 10: Brightness | 120 | 0x78 | 16 |
Zone 10: Excitement | 121 | 0x79 | 16 |
Zone 10: Background | 122 | 0x7A | 16 |
Zone 10: Mover Range | 123 | 0x7B | 16 |
Zone 10: Mover Speed | 124 | 0x7C | 16 |
Zone 10: Pattern | 125 | 0x7D | 16 |
Zone 10: Colour Palette | 126 | 0x7E | 16 |
Zone 10: FX Palette | 127 | 0x7F | 16 |
|
|
|
|
NOTES |
Continuous controls (brightness, excitement, background, mover range/speed, strobe, blinder, fog volume/speed, faders) map CC value 0 – 127 to 0 – 100%. |
Fog Duration and Fog Interval map CC value 0 – 127 to 0 – 300 seconds. |
Show Select, Pattern, and Colour Palette are indexed from 0: CC value 0 selects the first item in the list, 1 the second, and so on. Pattern and Colour Palette values past the end of the list select the last item. |
FX Palette is indexed from 1: CC value 1 selects the first FX Palette, 2 the second, and so on. CC value 0 clears the FX Palette. |
Faders are numbered 0 – 7 (the same numbering as OSC). Zones were called Groups in earlier versions; zones 5 – 10 are new CC ranges. MaestroDMX v1.6 listens on MIDI channel 16. |