Differences

This shows you the differences between two versions of the page.

--- trigger:MIDI [2017/11/06 06:26] – [Controller Change] peternlewis
+++ trigger:MIDI [2025/03/01 02:53] (current) – [Packet] peternlewis
@@ Line 3: / Line 3: @@
 You can trigger on specific notes, specific controller changes (v8+), or on any raw MIDI packet (v8+).
-If the *Allow Recording* checkbox is on, and the note field has the text focus, and you press a MIDI note, then Keyboard Maestro will set the fields to the correct value for you; similarly for the controller field or the raw packet fields.
+If the *Allow Recording* (*MIDI Learn*) checkbox is on, and the note field has the text focus, and you press a MIDI note, then Keyboard Maestro will set the fields to the correct value for you; similarly for the controller field or the raw packet fields.
 ====== Notes =======
@@ Line 11: / Line 11: @@
 You can configure the trigger to execute the macro when the note is received from a particular device, from a particular channel or from any device or channel.
-The [[token:TriggerValue|%TriggerValue%]] token will hold `channel,note,velocity,device` for press and release (just the velocity was included prior to version 8.0).
+The [[token:TriggerValue|%TriggerValue%]] token will hold `channel,note,velocity,device` for press and release (8.0.4+) (just the velocity was included prior to version 8.0).  You can easily access the individual parts using the token array notation:
+^ Token      ^ Value ^
+| %TriggerValue[1]%    | Channel         |
+| %TriggerValue[2]%    | Note            |
+| %TriggerValue[3]%    | Velocity        |
+| %TriggerValue[4]%    | Device          |
 ====== Controller Change =======
@@ Line 29: / Line 36: @@
 * changed >= — every time it changes and is greater than or equal to the specified value and was not previously.
 * changed > — every time it changes and is greater than the specified value and was not previously.
-* decreases — every time it changes and is less than the previous value.
+* decreases — every time it changes and is less than the previous value. (v8.0.4+)
-* increases — every time it changes and is greater than the previous value.
+* increases — every time it changes and is greater than the previous value. (v8.0.4+)
 For the *changed* variants, the first controller change Keyboard Maestro sees is assumed to have changed if it matches the conditions.  After that, only changes from the previous state are considered.
@@ Line 36: / Line 43: @@
 You can configure the trigger to execute the macro when the controller change is received from a particular device, from a particular channel or from any device or channel.
-The [[token:TriggerValue|%TriggerValue%]] token will hold `channel,controller,value,device`.
+The [[token:TriggerValue|%TriggerValue%]] token will hold `channel,controller,value,device` (8.0.4+).  You can easily access the individual parts using the token array notation:
-====== Raw Packet =======
+^ Token      ^ Value ^
+| %TriggerValue[1]%    | Channel         |
+| %TriggerValue[2]%    | Controller      |
+| %TriggerValue[3]%    | Value           |
+| %TriggerValue[4]%    | Device          |
+====== Packet =======
 This is a rather advanced trigger that requires some knowledge of the MIDI protocol (v8+).  You can configure the minimum and maximum size of the packet, as well as the range of the first two bytes, and a regex that matches the specified packet (the format will be a sequence of space-separated hex values).
@@ Line 44: / Line 58: @@
 This should allow you to capture things like SysEx and HUI protocol packets and the like.
-The [[token:TriggerValue|%TriggerValue%]] token will the space-separated hex values representing the packet.
+The [[token:TriggerValue|%TriggerValue%]] token will the space-separated hex values representing the packet, followed by a comma, followed by the source device. You can get the two parts with.
+^ Token      ^ Value ^
+| %TriggerValue[1]%    | Data            |
+| %TriggerValue[2]%    | Device          |
+If you extract just the bytes (ie, everything up until the first comma), then you can then easily access the individual parts using the token array notation, eg `%DataVar[3] %` will be the third value (8.0.4+) — note the `{space}` in `]{space}%`, the space is the separator for the array, instead of the default comma.