https://github.com/meownoid/mmk1-relay

Maschine MK1 Relay
https://github.com/meownoid/mmk1-relay

cabl midi midi-controller native-instruments osc rtmidi

Last synced: about 1 month ago
JSON representation

Maschine MK1 Relay

• Host: GitHub
• URL: https://github.com/meownoid/mmk1-relay
• Owner: meownoid
• Created: 2024-01-16T14:05:57.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2024-02-04T00:12:36.000Z (11 months ago)
• Last Synced: 2024-02-04T01:24:25.171Z (11 months ago)
• Topics: cabl, midi, midi-controller, native-instruments, osc, rtmidi
• Language: C++
• Homepage:
• Size: 23.4 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Maschine MK1 Relay

This application communicates with the [Maschine MK1](https://en.wikipedia.org/wiki/Maschine) hardware and relays pad presses and encoder movements as [MIDI](https://en.wikipedia.org/wiki/MIDI) messages, and button presses as [OSC](https://en.wikipedia.org/wiki/Open_Sound_Control) messages. It is built on the modified version of the [cabl](https://github.com/shaduzlabs/cabl) library. It is tested on macOS only but might work on other platforms.

* Pads are sent as MIDI Note ON, MIDI Note OFF and Aftertouch in between

* Encoders are sent as MIDI CC

* Button presses are sent as OSC messages with addresses `/MMK1/*` or `/MMK1/Shift/*` and values `on` and `off`

## Usage

Check out command line arguments and their descriptions.

```

./mmk1-relay -h

```

## Known Issues

* Device must be plugged in before running the `mmk1-relay`

* Un-plugging and plugging back the device during the `mmk1-relay` runtime is not supportd, if device is re-plugged, `mmk1-relay` should be restarted

## Installation

To begin, clone and build the [modified version](https://github.com/meownoid/cabl) of the cabl library.

Next, make sure to install required dependencies.

```

brew install rtmidi boost cxxopts

```

Clone the repository alongside the `cabl` (so both `cabl` and `mmk1-relay` are in the same directory) and proceed to build the project.

```

git clone https://github.com/meownoid/mmk1-relay.git

cd mmk1-relay

```

```

mkdir build && cd build

cmake ..

make

```

Finally, you can relocate the binary `build/mmk1-relay` to the desired location.