Classes | External Control > MIDI

MIDIResponder : Object

Register multiple functions to be evaluated when MIDI events occur


NOTE: SC 3.5 added the MIDIFunc and MIDIdef classes. These are faster, and aim to have a more convenient, logical and consistent interface, which shares a common design with OSCFunc and OSCdef. They also provide support for all MIDI message types.

MIDIResponder is an abstract class. Its subclasses allow functions to be registered to respond to midi events.

Read the general help file here and then see the individual help files.

Respond to control messages
Respond to note-on messages
Respond to note-off messages
Respond to pitch bend messages
Respond to aftertouch messages
Respond to programchange messages

Creation and initialization

The function to execute when the incoming MIDI event matches the responder. The function takes the arguments src, chan, A, B (or for Bend, ProgramChange and Touch: src, chan, value).
If a number is given, the responder will fire only for messages coming in from this port. The number may be the system UID (obtained from MIDIClient.sources[index].uid) or the index itself. If nil, the responder will match any port.
The MIDI channel(s) to match.
The control or note number(s) to match.
The value(s) to match.
The velocities to match.
If true, install the responder automatically so it is active and ready to respond. If false, then it will be inactive.
If true, then if the midi event is matched, cease testing any further responders. eg. if a CCResponder matches port, chan and num, and swallowEvent is set to true, then no further CCResponders will be offered the chance to respond to the event. The event is "swallowed". By default this is false. Note that doing this will prevent any other responders of this type from responding, including ones added behind the scenes in classes. Note also that this functionality is sensitive to the order in which responders are added.

Any of the matching values may be one of the following:

Match anything. eg. if chan is nil, then respond to any MIDI channel.
Match only this specific number.
Match any item in the array. Any kind of Collection will work here.
Evaluate the function with the incoming value as the argument. The function should return true or false.

For instance, the following example would respond to note on messages from any port, channels 2 and 7 only, even numbered note numbers only, and only velocity values greater than 50.

MIDIResponders automatically initialize the MIDIClient with 1 standard device. This means the first time you install any MIDIResponder, it will make sure that MIDI has been initialized. If you have more devices or a specific setup, simply initialize the MIDIClient yourself before using any MIDIResponders.


Just call .remove on the responder.

Or remove all of a specific class:

or remove all midi responders in all classes:

Class Methods

Inherited class methods

Undocumented class methods


Instance Methods

Inherited instance methods

Undocumented instance methods


.function = value

.match(src, chan, num, value)


.matchEvent = value


.respond(src, chan, num, value)


.swallowEvent = value

.value(src, chan, a, b)