Skip to content

Latest commit

 

History

History
142 lines (88 loc) · 4.17 KB

README.md

File metadata and controls

142 lines (88 loc) · 4.17 KB

Eight Track LR Logo

Eight Track LR Router

Routes MIDI messages from Ableton Live to Reason

Note: This is an app exclusively for Macs, there is no Windows version!

Getting started

MIDI setup

The idea of this project is to use eight tracks in the Ableton Live session view to control up to 64 devices in the Reason rack independently.

To make this work, you have to use the macOS app Audio MIDI Setup to configure five new IAC ports. One port is used to send MIDI messages from Live to 8tlr-router, four ports are used to send MIDI messages from 8tl-router to Reason.

Screenshot: MIDI Studio with MIDI ports set up

Configuration file

After adding the ports using the MIDI Studio in the Audio MIDI Setup app, create a configuration file called 8tlr-router.config.yaml, either in your home directory, or whereever you are planning to run the 8tlr-router.

The config file should define your MIDI ports like so:

---
portName:
  input: IAC Live to Router
  output:
    - IAC Router to Reason 1
    - IAC Router to Reason 2
    - IAC Router to Reason 3
    - IAC Router to Reason 4

Download and installation

Download the latest version on the release page.

Unzip and move the app contained in the zip file to your applications folder.

“XYZ Is Damaged and Can’t Be Opened. You Should Move It To The Trash”

If you get this error, open up a terminal, go to the applications folder, and run this command:

sudo xattr -c Eight\ Track\ LR\ Router.app

You need admin privileges to do this.

This is, unfortunately, a security measure by Apple that prevents apps downloaded from the internet from getting executed unless they are approved by Apple.

See discussion here: https://discussions.apple.com/thread/253714860?sortBy=best

Development

Initial setup

Clone this GitHub repository to your local file system.

Make sure you have the Node.js version that is specifiedv in .nvmrc installed.

Make sure you have Yarn installed (run corepack enable).

Install dependencies:

yarn

Set up a 8tlr-router.config.yaml as explained above in section Configuration file.

Running in local dev mode

Run in local dev mode with this command:

yarn start

This project uses debug for logging debug messages. They can help you understand what's going on.

To run with debug messages on:

DEBUG=* yarn start

To show only debug messages from the 8TLR Router program, not from third-party-packages:

DEBUG=8tlr-router:* yarn start

You can show debug messages only from a spefific logger. For example, to see only logs for control change messages that were sent out:

DEBUG=8tlr-router:midi:router:cc yarn start

Publishing a new release

All changes should be introduced to the main branch via pull request. Use “squash and merge" to merge the PR.

Create a GitHub access token with Settings → Developer settings → Personal access tokens → Tokens (classic).

Grant the tokens access to scopes repo and write:packages.

If you already have a token that has expired, you can use “regenerate token”.

Create a .env file in the local repository clone root by copying .env.example.

Replace the bogus GitHub token in the .env file with the real one.

Bump the version number in package.json using semantic versioning.

Commit and push the changes to the main branch using a conventional commit message, e.g. chore: release v6.6.6.

Run the publish script:

yarn publish

After successfully running the publish script, go to the releases page on GitHub — there should be a new release draft for the version you have just published.

Click on the release draft, then click on the pencil iconm (“edit”).

Click on the “publish release”.

You can now download the release zip file and install it on you Mac, as described above in section Download and installation.