PrimoKKMK1Bridge 1.1

The second release of PrimoKKMK1Bridge: a custom Native Instruments Komplete Kontrol S-series MK1 driver for macOS bringing complete configurability, basic NKS support and Reaper DAW integration to the no longer supported MIDI controller. PrimoKKMK1Bridge replaces the need for the Native Instruments drivers (NIHardwareAgent, NIHostIntegrationAgent) and Controller Editor.

Version 1.1 (20261113.0104) · macOS 14 or later · Apple Silicon and Intel

Download

Each download contains the editor app, Primo KK MK1 Control Editor, with the bridge built in. It's all you need; pick the one for your Mac.

Download	For	SHA-256
PrimoKKMK1Editor-1.1-macOS-arm64.zip	Apple Silicon Macs (the smaller download)	227f6355b192db14ec0d396e94f16a084908708ee94d18477a3165b5325beed3
PrimoKKMK1Editor-1.1-macOS-universal.zip	Intel Macs (it runs on Apple Silicon too)	162081f15f28c82b47398d22730ab0b3a29bf086622ee499c7aeca5b64749069

Install

1. Unzip it, and move PrimoKKMK1Editor.app to Applications.
2. The app is signed for local use only (ad hoc) and isn't notarized by Apple, so macOS blocks it the first time. Either open it once, then click Open Anyway in System Settings ▸ Privacy & Security, or run:

   xattr -dr com.apple.quarantine /Applications/PrimoKKMK1Editor.app

3. Open the app and turn the bridge on with the switch in the toolbar. The bridge keeps running after you quit the editor.

Updating from 1.0: turn the bridge off with the editor's switch, quit the editor, replace the app, then open it and turn the bridge back on. Your config file is kept, with the assignments it has, so REAPER mode keeps 1.0's buttons. To get 1.1's new REAPER defaults (below), use Reset to Default Settings… on the editor's Settings page and save (it resets every setting except REAPER mode), or change the buttons one by one in the editor.

The user guide covers setup, every mode and view, and every default assignment. The editor's Help menu opens it.

What's new in 1.1

REAPER mode

• New button defaults: Preset ▲ / ▼ load screensets 1 / 2; Navigate ▲ / ▼ zoom horizontally (with Shift, vertically); Navigate ◀ / ▶ move the edit cursor one pixel (with Shift, to the previous / next grid division); Scale shows or hides the MIDI editor windows (with Shift, MIDI step input); Arp sets the track's automation mode to write (with Shift, trim/read). (#11, #12, #13)
• Pan in Mix view: Shift + a knob pans its track; the displays show the pans while Shift is held. (#16)
• Navigate knob: picking a track in Mix view switches to Track view. In the Komplete Kontrol view, the track you pick is also selected in REAPER, and the left display shows its name. (#17)
• REAPER quitting is noticed: the displays go back to waiting for OSC from REAPER, and the bridge reconnects when REAPER is reopened. (#18)
• OSC errors don't stop the bridge: if its port is taken (say by a second bridge), it shows why on the displays and tries again every 3 seconds.
• MIDI Editor actions: buttons can run actions from REAPER's MIDI Editor section (midiaction:<ID>).

Light guide

• The selected track's colour on the keys, with a brightness setting. A small REAPER script sends the colours; install or uninstall it from the editor's Settings page.
• Startup states: a rainbow when the keyboard connects, purple while waiting for REAPER, and red when the OSC link can't open. (#15)

Editor

• Launch Bridge at Login in Settings. (#2)
• Verbose Logging in Settings, with Show Log. (#7)
• Settings sections and labels renamed (#14), and the Help menu opens the user guide website.

Fixes

• The bridge runs on macOS 14 and 15. In 1.0 it was built for macOS 26 by mistake, so on earlier versions the editor opened but the bridge didn't start.

Documentation

• The user guide, now also a website: https://gsenger3.github.io/PrimoKKMK1Bridge/ (#8)
• One README for building and testing. (#4)
• Apple Silicon and universal downloads from one release build. (#19)

Known limits

• Tested on an S61 MK1 (firmware 72) with macOS 26 and REAPER 7.61, on Apple Silicon. The Intel build has been tested under Rosetta, not yet on an Intel Mac. The S25, S49 and S88 MK1 should work but haven't been tried.
• No parameter names in the Komplete Kontrol view. Komplete Kontrol's NKS parameter names and values aren't available to the bridge.
• The keyboard stays in native mode after the bridge quits. Its knobs stay silent until you unplug and replug it.

Build from source

See Build and run.

PrimoKKMK1Bridge 1.0

The first release of PrimoKKMK1Bridge: a Native Instruments Komplete Kontrol S-series MK1 keyboard, fully usable on macOS without NI's software.

Version 1.0 (20261109.2354) · macOS 14 or later · Apple Silicon (arm64)

Download

PrimoKKMK1Editor-1.0-macOS-arm64.zip contains the editor app, Primo KK MK1 Control Editor, with the bridge built in. It's all you need.

SHA-256: 9f97d32ba5f0021ad62db6b15923f9b209d1e0dadbcd1474ec51266849e4bbf0

Install

1. Unzip it, and move PrimoKKMK1Editor.app to Applications (or wherever you like).
2. The app is signed for local use only (ad hoc) and isn't notarized by Apple, so macOS blocks it the first time. Either open it once, then click Open Anyway in System Settings ▸ Privacy & Security, or run:

   xattr -dr com.apple.quarantine /Applications/PrimoKKMK1Editor.app

3. Open the app and turn the bridge on with the switch in the toolbar. The bridge keeps running after you quit the editor.

The first run creates the config at ~/Library/Application Support/PrimoStudios/PrimoKKMK1Bridge/PrimoKKMK1Bridge.json, in plain MIDI mode. To control REAPER, turn REAPER mode on in the editor's Settings page and set up REAPER once.

What's in 1.0

• Every control as MIDI: each button, knob turn, knob touch and the Navigate knob sends a CC on the virtual port Primo Komplete Kontrol MK1, with a second layer on channel 2 while Shift is held. The keys, pitch strip and mod strip are merged into the same port. The button lights and the nine displays are driven too.
• REAPER mode (OSC): a Mix view (8 track volumes per bank) and a Track view (volume, pan, mute, solo, record arm and sends of the selected track). Transport and markers, metronome, record mode, undo and redo, save and render, screensets, plugin windows, and MIDI panic all run from the keyboard.
• Komplete Kontrol view: NKS-style CCs like Novation's Launchkey. The displays read ENCODER 1–8, and Page ◀ / ▶ and Navigate ◀ / ▶ page through NKS pages.
• Editor: a drawing of the keyboard; click a control to set its CC or REAPER command. The toolbar switch starts and stops the bridge. Saved changes apply to a running bridge within a second or two.
• Versions: the About box and PrimoKKMK1Bridge --version show Major.minor (Build ID).

Known limits

• Apple Silicon only. On an Intel Mac, build it from source with editor/build.sh.
• Tested on an S61 MK1 (firmware 72) with macOS 26 and REAPER 7.61. The S25, S49 and S88 MK1 should work but haven't been tried.
• No parameter names in the Komplete Kontrol view. Komplete Kontrol's NKS parameter names and values aren't available to the bridge.
• The keyboard stays in native mode after the bridge quits. Its knobs stay silent until you unplug and replug it.

Build from source

See Build and run.