rynr/launchpad

Library to access a Novation Launchpad in a java application.

Launchpad

This library can be used to access a Novation Launchpad from a java application.

Usage

You can directly use it from maven central:

<dependency>
  <groupId>org.rjung.util</groupId>
  <artifactId>launchpad</artifactId>
  <version>1.0</version>
</dependency>

To send colors the the launchpad, the methods set(pad, color):

launchpad.set(Pad.A4, Color.RED);
launchpad.set(Pad.find(3, 1), Color.GREEN);

To retrieve messages, implement a LaunchpadReceiver and register it to the launchpad instance. The LaunchpadReceiver will now be called always, when a Command is received.

new Launchpad(new LaunchpadHandler() {
    public void recieve(MidiCommand command) {
        System.out.println(command);
    }
});

Example

There's also a rewritten version of the Games of Life in the branch life.

Build it yourself

The build uses maven. You don't need to install anything besides a java 8 development kit (jdk8). Now just run:

./mvn clean package

The build jar can be found in the target-folder.

Info

• Info
• Github
• Bugs
• Sonar
• 
• 

launchpad's Issues

From findbugs: org.rjung.utils.launchpad.MidiCommand$Builder.setDataBytes(byte[]) may expose internal representation by storing an externally mutable object into MidiCommand$Builder.databytes

See http://findbugs.sourceforge.net/bugDescriptions.html#EI_EXPOSE_REP2

MidiCommand.Builder is not building the StatusByte correctly

It's doing a bitwise and (&) instead of a bitwise or (^)

From findbugs: new org.rjung.utils.launchpad.MidiCommand(byte, byte[]) may expose internal representation by storing an externally mutable object into MidiCommand.data

See http://findbugs.sourceforge.net/bugDescriptions.html#EI_EXPOSE_REP2

From findbugs: org.rjung.utils.launchpad.MidiCommand.getData() may expose internal representation by returning MidiCommand.data

See http://findbugs.sourceforge.net/bugDescriptions.html#EI_EXPOSE_REP

Clojure library based on rynr/launchpad

Just a heads up, I've made a Clojure wrapper around this library.

This is just to let you know it exists, and to thank you for this wonderful library that made my life a lot easier.

preoctopus/launchpad-clj

It is very basic at the moment, but will improve as we begin to integrate it.

No Tests at all!!!

Currently the code is straight forward, but when adding more it would be nice to have the defaults tested.

Rewrite to use javax.sound.midi.*

With this change it would be fine to use it with windows as well.

Not registering the `CON1`-`8` Pads when pressed

The Pads 1-8 are not recognized when pressed.

Hide `Receiver` implementation

To receive midi messages, the Launchpad class does implement a Receiver. Like this the method public void send(MidiMessage message, long timeStamp) is public available and should not.

From findbugs: Should org.rjung.utils.launchpad.Launchpad$Reader be a _static_ inner class?

See http://findbugs.sourceforge.net/bugDescriptions.html#SIC_INNER_SHOULD_BE_STATIC

From findbugs: new org.rjung.utils.launchpad.Launchpad(File) invokes Thread.start()

See http://findbugs.sourceforge.net/bugDescriptions.html#SC_START_IN_CTOR