Home

Awesome

Ableton Push

abletonpush is a library for working with the Ableton Push in the browser. A working example can be found here. It is designed to allow a user to play notes and chords in the Isomorphic pad layout on the Push. The pad is setup in C Major scale and each pad pressed will be relative to that. The pads will be coloured to show the layout and pads will change colour when pressed.

<img src="https://garrensmith.com/push.svg" width="300">

Installation

The abletonpush module is distributed through npm and is compatible with webpack and browserify. You can install it:

npm install --save @garrensmith/abletonpush

Table Of Contents

Usage

abletonpush is only designed to run in the browser. It uses the webmidi library underneath. Currently only Google Chrome supports webmidi. With Google Chrome, web midi will work with http on a localhost port but for a production site it will require https.

import AbletonPush from 'abletonpush'

const abletonpush = new AbletonPush();

abletonpush.on('note:on', ({note, octave}) => {
  console.log(`note ${note}:${octave}` was pressed);
});

Once the library has connected to an Ableton Push it will colour the pads on the Push so that can be used as an Isomorphic keyboard.

Events

abletonpush is an eventemitter at its core. It sends events for any interaction with the Push device.

EventDescription
push:connectedA push deviced is connected
push:disconnectedA push deviced is disconnected.
push:failedFailed to access the push's inputs and outputs
push:encoder:${name}A push encoder with the name has togged in a direction
push:encoder:${number}A push encoder with the number has togged in a direction
note:onA pad has been pressed
note:offA pad has been released
push:chordA major/minor chord was played (this is very experimental)

SetColourButtons

This sets the colours for the buttons just below the encoders. This can be used along with the buttonColours variable.

import AbletonPush from 'abletonpush';
import { buttonColors } from 'abletonpush';

const push = new AbletonPush();
push.setColourButtons(102, buttonColors.red);

Take a look at Ableton Push Midi interface for the correct button numbers

Logging

Passing logging: true when creating the AbletonPush object will enable logging.

const push = new AbletonPush({logging: true})

License

Apache license 2.0