https://github.com/agraef/apcmini
AKAI APC mini driver for Pd
https://github.com/agraef/apcmini
Last synced: about 1 year ago
JSON representation
AKAI APC mini driver for Pd
- Host: GitHub
- URL: https://github.com/agraef/apcmini
- Owner: agraef
- License: gpl-3.0
- Created: 2023-06-08T20:38:37.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-02-22T08:52:40.000Z (over 2 years ago)
- Last Synced: 2025-02-10T15:32:36.266Z (over 1 year ago)
- Language: Lua
- Size: 198 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# AKAI APC mini driver for Pd
This external implements a simplified interface between Pd and the APC mini. It works with both the [original version](https://www.akaipro.com/apc-mini) and the [mk2 version](https://www.akaipro.com/apc-mini-mk2) 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](https://agraef.github.io/pd-lua/) is required (and Pd, of course; both [vanilla Pd](http://msp.ucsd.edu/software.html) and [Purr Data](https://agraef.github.io/purr-data/) will work, the latter already includes pd-lua). MIDI data is encoded in [SMMF](https://bitbucket.org/agraef/pd-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](ardour-clip-launcher.md) file.
- koala-sampler.pd can be used to control Marek Bereza's [Koala Sampler](https://www.koalasampler.com/) application; documentation for this patch is in the [koala-sampler.md](koala-sampler.md) file.
Copyright © 2023, 2024 by Albert Gräf , distributed under the GPL (see COPYING)