Skip to content

Latest commit

 

History

History
73 lines (52 loc) · 2.41 KB

README.md

File metadata and controls

73 lines (52 loc) · 2.41 KB

autoroute

USB MIDI command-line automatic patchbay for Linux. Connects USB MIDI devices together as they get plugged in, according to configuration.

No GUI means it can run on simple devices such as a Raspberry Pi.

autoroute (list | connect [--config=configfile] | install)

Usage

Autoroute is simple to use:

  • autoroute list shows all available USB MIDI device ports
  • autoroute connect wires devices together according to the config file (./autoroute.conf is used by default)
  • autoroute install sets up autoroute as a systemd service & udev callback that triggers on boot and everytime a USB MIDI device is connected or disconnected.

Autoroute requires python 3.5. Built-in service installer requires systemd.

Installation

At a terminal, from the raspberrypi where autoroute is intended to run:

git clone https://github.com/fralalonde/autoroute
cd autoroute

# get device names
./autoroute list

# edit the configured routes, see configuration section in README
nano autoroute.conf
sudo cp autoroute.conf /usr/local/etc/autoroute.conf

# set up udev to rerun autoroute everytime USB MIDI config changes
sudo python3 autoroute install

# reload udev (or just reboot)
sudo udevadm control --reload-rules && udevadm trigger

Configuration

The included autoroute.conf is a sample, and needs to replaced with entries from your own setup.

Once installed, autouroute reads the config from /etc/autoroute.conf

Config file entries can be of two types:

  • ignore name of device
  • connect source device -> target device

Lines starting with # are comments. Device names have to match exactly the ones reported by the autoroute list command, excluding the [device,port]. If a configured device is not currently connected it is simply ignored.

# Ignored devices
ignore Timer
ignore Announce
ignore Midi Through Port-0

# Connections
connect USB Oxygen 49 MIDI 1 -> Arturia BeatStep MIDI 1
connect Arturia BeatStep MIDI 1 -> MicroBrute MIDI 1
connect Arturia BeatStep MIDI 1 -> GS-10 MIDI
connect Arturia BeatStep MIDI 1 -> GS-10 Control
connect Arturia BeatStep MIDI 1 -> R3 MIDI 1

Thanks

Adapted from https://neuma.studio/rpi-as-midi-host.html to handle multi-port devices and fixed config.

FAQ

Why choose that name?

  • Autoroute is french for Highway and translates to german as Autobahn, which is a great album.