jcalebbr/smk25v2

This project is a controller script that lets a specific piece of MIDI keyboard hardware, the M-VAVE SMK25 II, work properly with Bitwig Studio, a digital audio workstation used for making music. It is written for Linux and supports connecting the keyboard either over USB or Bluetooth. Installation is straightforward: you download the repository, run an install script from a terminal, then add the controller inside Bitwig's settings by selecting M-VAVE as the vendor and SMK25 II as the device. Bitwig automatically detects new controller scripts without needing a restart in most cases. For USB users, there are specific recommended port names to select. Bluetooth users need a few extra steps, including creating a virtual MIDI device on Linux and routing the Bluetooth connection through a tool called qpwgraph so Bitwig can see the incoming signals. The repository includes an optional custom preset file that changes some of the keyboard's internal button and knob behavior, which the script's default settings are built around. Without loading this preset, users can instead use a built in capture mode that logs exactly what each button, knob, and pad sends, so they can manually match those values to Bitwig's own binding settings. Once set up, the keyboard's keys and pads act as normal music input into Bitwig, while dedicated knobs and buttons control things like the arpeggiator mode, octave range, tempo, and transport functions such as play, stop, and record. The README also includes a troubleshooting section covering common problems like ports being selected in the wrong order, transport buttons not responding, and general Bluetooth connectivity setup. The project builds on an earlier community project for M-VAVE controllers and is released under the GPL-3.0 license.