launchpad

Build Status

This gem provides a ruby interface to access novation's launchpad programmatically. LEDs can be lighted and button presses can be responded to. Internally, launchpad's MIDI input/output is used to accomplish this.

The interfaces should be rather stable now (sorry, I changed quite a bit since the last release), so experiment with them and comment on their usability. This still is work in progress. If you need anything or think the interfaces could be improved in any way, please contact me.

Sometimes, the launchpad won't react to anything or react to/light up the wrong LEDs. Don't despair, just dis- and reconnect the thing. It seems that some (unexpected) MIDI signals make it hickup.

More Info

If you don't know what launchpad is, visit:

If you're into other languages or want to know what goes on behind the scenes MIDI wise, have a look at:

Requirements

Compatibility

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

Installation

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

gem install launchpad

Usage

There are two main entry points:

This is a simple example (only requiring the device for output) that switches on all LEDs (for testing), resets the launchpad again and then lights the grid button at position 4/4 (from top left).

require 'launchpad/device'

device = Launchpad::Device.new
device.test_leds
sleep 1
device.reset
sleep 1
device.change :grid, :x => 4, :y => 4, :red => :high, :green => :low

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

require 'launchpad'

interaction = Launchpad::Interaction.new
interaction.response_to(:grid, :down) do |interaction, action|
  interaction.device.change(:grid, action.merge(:red => :high))
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 with interaction.

Future plans

Changelog

v.0.3.0

v.0.2.2

v.0.2.1

v.0.2.0

v0.1.1

v0.1.0

Copyright

Copyright © 2009 Thomas Jachmann. See LICENSE for details.