This external implements a simplified interface between Pd and the APC mini. It works with both the original version and the mk2 version of the device, and manages on its own all the special keys and corresponding modes, including the softkeys and fader assignment. Controller input is translated to symbolic messages to be interpreted by the host application. The host then only needs to provide application-specific data about the track modes (solo, mute, etc.) and the status of the launchpad.
The external is written in Lua, so pd-lua is required (and Pd, of course; both vanilla Pd and Purr Data will work, the latter already includes pd-lua). MIDI data is encoded in SMMF, the corresponding midi-input and midi-output abstractions are included.
More details about the message protocol can be found in the comment section at the beginning of the apcmini.pd_lua file in the lib subdirectory. Please also check the included help patch for an introductory example showing how to use the external.
Two more comprehensive examples are also included, with corresponding patches in the main source directory and auxiliary files in the ardour-clip-launcher and koala-sampler subfolders, respectively.
-
ardour-clip-launcher.pd interfaces the APC mini to Ardour's clip launcher; documentation for this patch is in the ardour-clip-launcher.md file.
-
koala-sampler.pd can be used to control Marek Bereza's Koala Sampler application; documentation for this patch is in the koala-sampler.md file.
Copyright © 2023, 2024 by Albert Gräf [email protected], distributed under the GPL (see COPYING)