A minimal tempo bridge between Pioneer Pro DJ Link and Ableton Link.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src/beat_carabiner
.gitignore
CHANGELOG.md
LICENSE
README.md
project.clj

README.md

beat-carabiner

A minimal tempo bridge between Pioneer Pro DJ Link and Ableton Link.

As suggested by marek-memsql, this is a minimal headless implementation of just enough features from beat-link-trigger to enable tempo and beat synchronization between a Pioneer Pro DJ Link session and an Ableton Link session. It is designed for headless, unattended operation so that it can be run on hardware like the Raspberry Pi.

As long as beat-carabiner is running, has an active connection to Carabiner, and sees an active Pro DJ Link Network (using its embedded copy of beat-link), it will slave the Ableton Link tempo and beat grid to match the Pioneer gear.

Installation

Install Carabiner, a Java runtime, and the latest beat-carabiner.jar from the releases page on your target hardware.

You may be able to get by with Java 6, but a current release will perform better and have more recent security updates.

You can either start Carabiner and beat-carabiner manually when you want to use them, or configure them to start when your system boots.

Usage

To start beat-carabiner manually, run:

$ java -jar beat-carabiner.jar

It will log to the terminal window in which you are running it. If you instead want to run it at system startup, you will probably also want to set a log-file path, so it logs to a rotated log file in your standard system logs directory, something like:

$ java -jar beat-carabiner.jar -L /var/log/beat-carabiner.log

Other options allow you to specify whether it should align to beats instead of whole bars, the port on which it should contact the Carabiner daemon, and how many milliseconds of latency it takes for beat packets from the CDJs to arrive and be processed (you can tweak this until you get good-sounding synchronization if necessary):

Options

-b, --beat-align                  Sync Link session to beats only, not bars
-c, --carabiner-port PORT  17000  Port number of Carabiner daemon
-l, --latency MS           20     How many milliseconds are we behind the CDJs
-L, --log-file PATH               Log to a rotated file instead of stdout
-h, --help                        Display help information and exit

Examples

Run without synchronizing bars, with a packet latency of 35 milliseconds:

$ java -jar beat-carabiner.jar -b --latency 35

License

Copyright © 2017 Deep Symmetry, LLC

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.