MonsterJam: Maschine JAM Bitwig Controller Extension

This is the source code repository for the MonsterJam Bitwig controller extension.

Precompiled releases can be found here.

User documentation, including installation instructions, can be found here.

Overview

This is intended as a replacement for Bitwig's bundled Maschine JAM extension. Requires Bitwig API 17+.

Compiling

Requirements

• OpenJDK 12.x
• Maven >= 3.1.0

Build and install

1. Follow the installation instructions for each of the above requirements.
2. Run mvn install.

Dual MIDI ports (mirror port)

The extension can be built with a second MIDI in/out port pair that mirrors all output sent to the hardware. This is useful for external tools (emulators, test harnesses, visualizers) that need to observe the controller's LED and strip state in real time. The secondary input port also forwards incoming MIDI to the extension, so an external tool can inject button presses and fader moves.

To enable, set the dualPorts Maven property to true:

mvn install -DdualPorts=true

The included bin/build-info.sh dev-build script enables dual ports automatically on non-master branches.

Debugging

1. Set an environment variable BITWIG_DEBUG_PORT to an unused port number.
2. Restart Bitwig.
3. Setup your debugger to connect to the port from step 1.

Contributing

Issues and requests welcome.