AKAI APC MINI Utils

This repository contains a set of utility script for Linux for AKAI APC Mini (1st edition) owners.

Requirements

The amidi command should be available in your system. On Ubuntu you can install with the following command:

apt install alsa-utils

Install and setup

Clone this repository, or download and extract it's content, for example inside the opt folder; or whatever you want: script will automatically search it's configuration file in the same folder as the script itself.

cd /opt 
git clone https://github.com/simobri/akai-apcmini-utils

Make sure all .sh script are marked as executable, if not, adjust settings with

cd akai-apcmini-utils
chmod +x *.sh 

Then you need to setup the HW address of your APC Mini controller inside the configuration file, to do so, plug in the device; then issue the following command to retrieve the list of all midi devices connected on your system

amidi -l

The output will be like

$ amidi -l
Dir Device    Name
IO  hw:1,0,0  APC MINI MIDI 1

Then configure the set_akai_apcmini_colors.conf file accordingly, for the above example:

# AKAI DEVICE
AKAI_DEVICE="hw:1,0,0"

You are now ready.

Usage

Follow the manufacturer manual to know which button address are which; please note that in such manual address are in Hex format, while script want decimal values.

Also note the followings:

• The square 'shift' button has no LED
• Faders are ignored for the purpose of this "toolbox" repository

For quick-reference, range are the following:

• Range 0-63 are the "pads" buttons, starting last row, first column and moving ahead shifting to right
• Range 64-71 are the round buttons ("track" buttons) just above the faders, starting from left
• Range 82-89 are the round buttons ("scene" buttons) at far right from top to bottom

The supported <ColorID> by the set_akai_apcmini_color.sh are the following:

• off
• green
• yellow
• red
• green_flash
• yellow_flash
• red_flash

Script Usage:

./set_akai_apcmini_color.sh <ButtonID> <ColorID>

Examples:

./set_akai_apcmini_color.sh 0 green
./set_akai_apcmini_color.sh 1 yellow
./set_akai_apcmini_color.sh 2 red
./set_akai_apcmini_color.sh 3 off

Extra

A color-test script is included inside this repository, simply run it to cycle all buttons trought all available color and mode (fixed or flash). Script can also be used for testing purpose, to test if all LEDs are working properly

./test_akai_apcmini.sh

External Links

• Manufacturer product manual page: https://www.akaipro.com/downloads#apcmini