launchpad_mk2

This gem provides a Ruby interface to access the Novation Launchpad MK2 programmatically. The code started life as a clone of Thomas Jachman's gem and was subsequently updated to handle the MK2 version of the Launchpad. The mapping of buttons and specification of colours completely changed when the MK2 was released, so lots of the original code in these areas has been re-written, but the interaction code is still largely intact.

• Novation's Launchpad MK2 MIDI programmer's reference was the sole source for helping me understand how to interact with the Launchpad.

• Due to limitations in the Portmidi gem, it's not possible to specify which channel is used to send MIDI messages. As such, all interaction with the Launchpad are done over the default channel 1. This means some workarounds have been needed to access functionality like flash and pulse, which usually require channel 2 messages. All of these workarounds have been implemented via sending System Exclusive messages as per the above reference guide.

• Roger B. Dannenberg's portmidi library
• Jan Krutisch's portmidi gem

The gem is known to be compatible with the following ruby versions:

• MRI 2.3.1

The gem is hosted on RubyGems, so in order to use it, you're gonna gem install it:

gem install launchpad_mk2

There are two main entry points:

• require 'launchpad_mk2/device', providing LaunchpadMk2::Device, which handles all the basic input/output stuff

• require 'launchpad_mk2/interaction' or just 'launchpad_mk2', additionally providing LaunchpadMk2::Interaction, which lets you respond to actions (button presses/releases)

This is a simple example (only requiring the device for output) that resets the launchpad and then lights the grid button at position 4/4 (from bottom left of 0/0).

require 'launchpad_mk2/device'

device = LaunchpadMk2::Device.new
device.reset_all
device.change :grid, :x => 4, :y => 4, :color => 72

This is an interaction example lighting all grid buttons in red when pressed and keeping them lit.

require 'launchpad_mk2'

interaction = LaunchpadMk2::Interaction.new
interaction.response_to(:grid, :down) do |interaction, action|
  interaction.device.change(:grid, action.merge(:color => 72))
end
interaction.response_to(:mixer, :down) do |interaction, action|
  interaction.stop
end

interaction.start

For more details, see the examples. examples/color_picker.rb is the most complex example of interaction.

All examples can be found in the examples folder and run as standalone Ruby applications (i.e., ruby examples/<file>.rb).

• Ensure all examples are working with MK2

Copyright (c) 2017 Andy Marks. See LICENSE for details.