https://github.com/andeemarks/clj-launchpad-mk2
This library provides a Clojure interface to access the Novation Launchpad MK2 programmatically.
https://github.com/andeemarks/clj-launchpad-mk2
clojure launchpad midi mk2 novation
Last synced: 2 months ago
JSON representation
This library provides a Clojure interface to access the Novation Launchpad MK2 programmatically.
- Host: GitHub
- URL: https://github.com/andeemarks/clj-launchpad-mk2
- Owner: andeemarks
- License: mit
- Created: 2017-08-17T04:22:28.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2022-02-06T21:25:52.000Z (over 3 years ago)
- Last Synced: 2025-02-20T20:16:25.122Z (3 months ago)
- Topics: clojure, launchpad, midi, mk2, novation
- Language: Clojure
- Homepage:
- Size: 132 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# clj-launchpad-mk2
[
](https://travis-ci.org/andeemarks/clj-launchpad-mk2) [](https://clojars.org/clj-launchpad-mk2) [](https://opensource.org/licenses/mit-license.php)
This library provides a Clojure interface to access the [Novation Launchpad MK2](https://global.novationmusic.com/launch/launchpad#) programmatically. The code started life as a clone of [Moumar's Clojar](https://github.com/moumar/clj-launchpad) 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, as has the input message handling code.
## More Info
- Novation's Launchpad MK2 MIDI [programmer's reference](https://global.novationmusic.com/sites/default/files/novation/downloads/10529/launchpad-mk2-programmers-reference-guide_0.pdf) was the sole source for helping me understand how to interact with the Launchpad.
## Installation
#### Leiningen/Boot
`[clj-launchpad-mk2 "1.0.2"]`
#### Gradle
`compile "clj-launchpad-mk2:clj-launchpad-mk2:1.0.2"`
#### Maven
```
clj-launchpad-mk2
clj-launchpad-mk2
1.0.2
```
## REPL Usage
```clojure
(require '[clj-launchpad-mk2.core :refer :all])
(require '[clj-launchpad-mk2.midi.core :as midi])
(def lpad (open)) ; first argument to all subsequent calls
(light-grid lpad 23) ; light all buttons
(light-row lpad 3 66) ; light a single row of buttons
(light-column lpad 3 99) ; light a single column of buttons
(flash lpad 5 5 60) ; flash a single cell between it's current colour and 60
(pulse lpad 4 4 10) ; pulse (adjust brightness) of a single cell
(light-cc lpad CC_CURSOR_RIGHT 11) ; light a specific control button
(light-cell lpad 0 0 35) ; light a specific cell
(clear-grid lpad) ; clear all cells
(scroll-text-once lpad "Launchpad" 54) ; scrolling text once only
(scroll-text lpad "MK2" 60) ; scroll text in a loop
(scroll-stop lpad) ; stop looped scrolling
(rgb lpad 0 0 0 0 0) ; progressively increase the RED component of a series of cells
(rgb lpad 0 1 16 0 0)
(rgb lpad 0 2 32 0 0)
(rgb lpad 0 3 48 0 0)
(rgb lpad 0 4 63 0 0)
(midi/set-button-press-handler ; "random" light pressed button
lpad
(fn
[msg]
(light-cell
lpad
(:x msg)
(:y msg)
(- 127 (+ (:x msg) (:y msg))))))
(close lpad) ; disconnect
```
You can also try `lein run` to run the examples in `demo.clj`.
## API
API documentation available [here](https://andeemarks.github.io/clj-launchpad-mk2/).
## To Do
- Fix midi error at end of demo.
## Copyright
Copyright (c) 2017 Andy Marks. See LICENSE for details.