AKAI Professional
AKAI Professional APC20
AKAI Professional APC20 is a MIDI hardware controller by AKAI Professional: 1 knob, 9 faders and 87 buttons.
It sends CC and Note on channels 1, 2, 3, 4, 5, 6, 7, 8. The profile cites 1 source. 97 of its controls are marked unverified: the number is our best reading, and Learn rebinds it in one move.
- Community notes
- From QLC+
- Layout generated automatically
- 97 unverified
- Kind
- hardware device
- Maker
- AKAI Professional
- Controls
- 97 controls
- Messages
- CC · Note
- MIDI channels
- 1, 2, 3, 4, 5, 6, 7, 8
- LED feedback
- none sent
- Layout
- generated automatically
- Data licence
- Apache-2.0, from QLC+ (NOTICE)
- Checked on hardware
- not yet
- Signals
midi/apc20/…- Port name matches
/^(akai\s+)?apc\s*20(\s+(midi|port))*(\s+\d+)?$/i
Layout generated automatically: QLC+ has no faceplate data, so this is a list of the controls, not a picture of the device.
Drag knobs and faders · tap pads and keys · or plug the real one in and press Connect. Nothing is sent anywhere unless you add a MIDI out.
MIDI implementation
Every control of AKAI Professional APC20 and the message it sends
Generated from the profile file, so it is the same table the on-screen controller plays. Channels are 1–16; numbers are real MIDI numbers.
| Control | Type | Message | Ch | Number | Signal | LED feedback | Evidence |
|---|---|---|---|---|---|---|---|
Slider 1 slider-1 |
fader | CC | 1 | 7 | midi/apc20/slider-1 |
— | unverified |
Slider Master slider-master |
fader | CC | 1 | 14 | midi/apc20/slider-master |
— | unverified |
Cue level cue-level |
knob | CC | 1 | 47 | midi/apc20/cue-level |
— | unverified |
Record arm 1 record-arm-1 |
button | Note · momentary | 1 | 48 · C3 | midi/apc20/record-arm-1 |
— | unverified |
Solo 1 solo-1 |
button | Note · momentary | 1 | 49 · C#3 | midi/apc20/solo-1 |
— | unverified |
Activator 1 activator-1 |
button | Note · momentary | 1 | 50 · D3 | midi/apc20/activator-1 |
— | unverified |
Play play |
button | Note · momentary | 1 | 51 · D#3 | midi/apc20/play |
— | unverified |
Clip stop 1 clip-stop-1 |
button | Note · momentary | 1 | 52 · E3 | midi/apc20/clip-stop-1 |
— | unverified |
Matrix 1-1 matrix-1-1 |
button | Note · momentary | 1 | 53 · F3 | midi/apc20/matrix-1-1 |
— | unverified |
Matrix 1-2 matrix-1-2 |
button | Note · momentary | 1 | 54 · F#3 | midi/apc20/matrix-1-2 |
— | unverified |
Matrix 1-3 matrix-1-3 |
button | Note · momentary | 1 | 55 · G3 | midi/apc20/matrix-1-3 |
— | unverified |
Matrix 1-4 matrix-1-4 |
button | Note · momentary | 1 | 56 · G#3 | midi/apc20/matrix-1-4 |
— | unverified |
Matrix 1-5 matrix-1-5 |
button | Note · momentary | 1 | 57 · A3 | midi/apc20/matrix-1-5 |
— | unverified |
Note mode note-mode |
button | Note · momentary | 1 | 80 · G#5 | midi/apc20/note-mode |
— | unverified |
Shift shift |
button | Note · momentary | 1 | 81 · A5 | midi/apc20/shift |
— | unverified |
Scene launch 1 scene-launch-1 |
button | Note · momentary | 1 | 82 · A#5 | midi/apc20/scene-launch-1 |
— | unverified |
Scene launch 2 scene-launch-2 |
button | Note · momentary | 1 | 83 · B5 | midi/apc20/scene-launch-2 |
— | unverified |
Scene launch 3 scene-launch-3 |
button | Note · momentary | 1 | 84 · C6 | midi/apc20/scene-launch-3 |
— | unverified |
Scene launch 4 scene-launch-4 |
button | Note · momentary | 1 | 85 · C#6 | midi/apc20/scene-launch-4 |
— | unverified |
Scene launch 5 scene-launch-5 |
button | Note · momentary | 1 | 86 · D6 | midi/apc20/scene-launch-5 |
— | unverified |
Slider 2 slider-2 |
fader | CC | 2 | 7 | midi/apc20/slider-2 |
— | unverified |
Record arm 2 record-arm-2 |
button | Note · momentary | 2 | 48 · C3 | midi/apc20/record-arm-2 |
— | unverified |
Solo 2 solo-2 |
button | Note · momentary | 2 | 49 · C#3 | midi/apc20/solo-2 |
— | unverified |
Activator 2 activator-2 |
button | Note · momentary | 2 | 50 · D3 | midi/apc20/activator-2 |
— | unverified |
Stop stop |
button | Note · momentary | 2 | 51 · D#3 | midi/apc20/stop |
— | unverified |
Clip stop 2 clip-stop-2 |
button | Note · momentary | 2 | 52 · E3 | midi/apc20/clip-stop-2 |
— | unverified |
Matrix 2-1 matrix-2-1 |
button | Note · momentary | 2 | 53 · F3 | midi/apc20/matrix-2-1 |
— | unverified |
Matrix 2-2 matrix-2-2 |
button | Note · momentary | 2 | 54 · F#3 | midi/apc20/matrix-2-2 |
— | unverified |
Matrix 2-3 matrix-2-3 |
button | Note · momentary | 2 | 55 · G3 | midi/apc20/matrix-2-3 |
— | unverified |
Matrix 2-4 matrix-2-4 |
button | Note · momentary | 2 | 56 · G#3 | midi/apc20/matrix-2-4 |
— | unverified |
Matrix 2-5 matrix-2-5 |
button | Note · momentary | 2 | 57 · A3 | midi/apc20/matrix-2-5 |
— | unverified |
Slider 3 slider-3 |
fader | CC | 3 | 7 | midi/apc20/slider-3 |
— | unverified |
Record arm 3 record-arm-3 |
button | Note · momentary | 3 | 48 · C3 | midi/apc20/record-arm-3 |
— | unverified |
Solo 3 solo-3 |
button | Note · momentary | 3 | 49 · C#3 | midi/apc20/solo-3 |
— | unverified |
Activator 3 activator-3 |
button | Note · momentary | 3 | 50 · D3 | midi/apc20/activator-3 |
— | unverified |
Rec rec |
button | Note · momentary | 3 | 51 · D#3 | midi/apc20/rec |
— | unverified |
Clip stop 3 clip-stop-3 |
button | Note · momentary | 3 | 52 · E3 | midi/apc20/clip-stop-3 |
— | unverified |
Matrix 3-1 matrix-3-1 |
button | Note · momentary | 3 | 53 · F3 | midi/apc20/matrix-3-1 |
— | unverified |
Matrix 3-2 matrix-3-2 |
button | Note · momentary | 3 | 54 · F#3 | midi/apc20/matrix-3-2 |
— | unverified |
Matrix 3-3 matrix-3-3 |
button | Note · momentary | 3 | 55 · G3 | midi/apc20/matrix-3-3 |
— | unverified |
Matrix 3-4 matrix-3-4 |
button | Note · momentary | 3 | 56 · G#3 | midi/apc20/matrix-3-4 |
— | unverified |
Matrix 3-5 matrix-3-5 |
button | Note · momentary | 3 | 57 · A3 | midi/apc20/matrix-3-5 |
— | unverified |
Slider 4 slider-4 |
fader | CC | 4 | 7 | midi/apc20/slider-4 |
— | unverified |
Record arm 4 record-arm-4 |
button | Note · momentary | 4 | 48 · C3 | midi/apc20/record-arm-4 |
— | unverified |
Solo 4 solo-4 |
button | Note · momentary | 4 | 49 · C#3 | midi/apc20/solo-4 |
— | unverified |
Activator 4 activator-4 |
button | Note · momentary | 4 | 50 · D3 | midi/apc20/activator-4 |
— | unverified |
Midi overdub midi-overdub |
button | Note · momentary | 4 | 51 · D#3 | midi/apc20/midi-overdub |
— | unverified |
Clip stop 4 clip-stop-4 |
button | Note · momentary | 4 | 52 · E3 | midi/apc20/clip-stop-4 |
— | unverified |
Matrix 4-1 matrix-4-1 |
button | Note · momentary | 4 | 53 · F3 | midi/apc20/matrix-4-1 |
— | unverified |
Matrix 4-2 matrix-4-2 |
button | Note · momentary | 4 | 54 · F#3 | midi/apc20/matrix-4-2 |
— | unverified |
Matrix 4-3 matrix-4-3 |
button | Note · momentary | 4 | 55 · G3 | midi/apc20/matrix-4-3 |
— | unverified |
Matrix 4-4 matrix-4-4 |
button | Note · momentary | 4 | 56 · G#3 | midi/apc20/matrix-4-4 |
— | unverified |
Matrix 4-5 matrix-4-5 |
button | Note · momentary | 4 | 57 · A3 | midi/apc20/matrix-4-5 |
— | unverified |
Slider 5 slider-5 |
fader | CC | 5 | 7 | midi/apc20/slider-5 |
— | unverified |
Record arm 5 record-arm-5 |
button | Note · momentary | 5 | 48 · C3 | midi/apc20/record-arm-5 |
— | unverified |
Solo 5 solo-5 |
button | Note · momentary | 5 | 49 · C#3 | midi/apc20/solo-5 |
— | unverified |
Activator 5 activator-5 |
button | Note · momentary | 5 | 50 · D3 | midi/apc20/activator-5 |
— | unverified |
Left left |
button | Note · momentary | 5 | 51 · D#3 | midi/apc20/left |
— | unverified |
Clip stop 5 clip-stop-5 |
button | Note · momentary | 5 | 52 · E3 | midi/apc20/clip-stop-5 |
— | unverified |
Matrix 5-1 matrix-5-1 |
button | Note · momentary | 5 | 53 · F3 | midi/apc20/matrix-5-1 |
— | unverified |
Matrix 5-2 matrix-5-2 |
button | Note · momentary | 5 | 54 · F#3 | midi/apc20/matrix-5-2 |
— | unverified |
Matrix 5-3 matrix-5-3 |
button | Note · momentary | 5 | 55 · G3 | midi/apc20/matrix-5-3 |
— | unverified |
Matrix 5-4 matrix-5-4 |
button | Note · momentary | 5 | 56 · G#3 | midi/apc20/matrix-5-4 |
— | unverified |
Matrix 5-5 matrix-5-5 |
button | Note · momentary | 5 | 57 · A3 | midi/apc20/matrix-5-5 |
— | unverified |
Slider 6 slider-6 |
fader | CC | 6 | 7 | midi/apc20/slider-6 |
— | unverified |
Record arm 6 record-arm-6 |
button | Note · momentary | 6 | 48 · C3 | midi/apc20/record-arm-6 |
— | unverified |
Solo 6 solo-6 |
button | Note · momentary | 6 | 49 · C#3 | midi/apc20/solo-6 |
— | unverified |
Activator 6 activator-6 |
button | Note · momentary | 6 | 50 · D3 | midi/apc20/activator-6 |
— | unverified |
Right right |
button | Note · momentary | 6 | 51 · D#3 | midi/apc20/right |
— | unverified |
Clip stop 6 clip-stop-6 |
button | Note · momentary | 6 | 52 · E3 | midi/apc20/clip-stop-6 |
— | unverified |
Matrix 6-1 matrix-6-1 |
button | Note · momentary | 6 | 53 · F3 | midi/apc20/matrix-6-1 |
— | unverified |
Matrix 6-2 matrix-6-2 |
button | Note · momentary | 6 | 54 · F#3 | midi/apc20/matrix-6-2 |
— | unverified |
Matrix 6-3 matrix-6-3 |
button | Note · momentary | 6 | 55 · G3 | midi/apc20/matrix-6-3 |
— | unverified |
Matrix 6-4 matrix-6-4 |
button | Note · momentary | 6 | 56 · G#3 | midi/apc20/matrix-6-4 |
— | unverified |
Matrix 6-5 matrix-6-5 |
button | Note · momentary | 6 | 57 · A3 | midi/apc20/matrix-6-5 |
— | unverified |
Slider 7 slider-7 |
fader | CC | 7 | 7 | midi/apc20/slider-7 |
— | unverified |
Record arm 7 record-arm-7 |
button | Note · momentary | 7 | 48 · C3 | midi/apc20/record-arm-7 |
— | unverified |
Solo 7 solo-7 |
button | Note · momentary | 7 | 49 · C#3 | midi/apc20/solo-7 |
— | unverified |
Activator 7 activator-7 |
button | Note · momentary | 7 | 50 · D3 | midi/apc20/activator-7 |
— | unverified |
Up up |
button | Note · momentary | 7 | 51 · D#3 | midi/apc20/up |
— | unverified |
Clip stop 7 clip-stop-7 |
button | Note · momentary | 7 | 52 · E3 | midi/apc20/clip-stop-7 |
— | unverified |
Matrix 7-1 matrix-7-1 |
button | Note · momentary | 7 | 53 · F3 | midi/apc20/matrix-7-1 |
— | unverified |
Matrix 7-2 matrix-7-2 |
button | Note · momentary | 7 | 54 · F#3 | midi/apc20/matrix-7-2 |
— | unverified |
Matrix 7-3 matrix-7-3 |
button | Note · momentary | 7 | 55 · G3 | midi/apc20/matrix-7-3 |
— | unverified |
Matrix 7-4 matrix-7-4 |
button | Note · momentary | 7 | 56 · G#3 | midi/apc20/matrix-7-4 |
— | unverified |
Matrix 7-5 matrix-7-5 |
button | Note · momentary | 7 | 57 · A3 | midi/apc20/matrix-7-5 |
— | unverified |
Slider 8 slider-8 |
fader | CC | 8 | 7 | midi/apc20/slider-8 |
— | unverified |
Record arm 8 record-arm-8 |
button | Note · momentary | 8 | 48 · C3 | midi/apc20/record-arm-8 |
— | unverified |
Solo 8 solo-8 |
button | Note · momentary | 8 | 49 · C#3 | midi/apc20/solo-8 |
— | unverified |
Activator 8 activator-8 |
button | Note · momentary | 8 | 50 · D3 | midi/apc20/activator-8 |
— | unverified |
Down down |
button | Note · momentary | 8 | 51 · D#3 | midi/apc20/down |
— | unverified |
Clip stop 8 clip-stop-8 |
button | Note · momentary | 8 | 52 · E3 | midi/apc20/clip-stop-8 |
— | unverified |
Matrix 8-1 matrix-8-1 |
button | Note · momentary | 8 | 53 · F3 | midi/apc20/matrix-8-1 |
— | unverified |
Matrix 8-2 matrix-8-2 |
button | Note · momentary | 8 | 54 · F#3 | midi/apc20/matrix-8-2 |
— | unverified |
Matrix 8-3 matrix-8-3 |
button | Note · momentary | 8 | 55 · G3 | midi/apc20/matrix-8-3 |
— | unverified |
Matrix 8-4 matrix-8-4 |
button | Note · momentary | 8 | 56 · G#3 | midi/apc20/matrix-8-4 |
— | unverified |
Matrix 8-5 matrix-8-5 |
button | Note · momentary | 8 | 57 · A3 | midi/apc20/matrix-8-5 |
— | unverified |
Have this unit? It takes a few minutes to check this data. Verify AKAI Professional APC20 with your unit →
LED feedback is not modeled for this one yet, so OAV does not light its LEDs. Every control still plays and sends its message.
Sources
- community QLC+ input profile Akai-APC20.qxi (non-official)community profile by Joep Admiraal; Apache-2.0; numbers read from QLC+ channel numbers, not checked by this project
Where this profile comes from
Imported from QLC+ on 2026-11-04. resources/inputprofiles/Akai-APC20.qxi
Notes
Imported from QLC+. The messages are what its community profile lists; nobody has checked them on a unit for this project, so every control is unverified. QLC+ has no faceplate data, so the layout was generated from the list of controls and does not look like the device. The port-name pattern was written from the model name, not read from a unit. QLC+ numbers these controls without a MIDI channel, so channel 1 here is a placeholder: the unit may send on another.
Port names it recognises
- matches
/^(akai\s+)?apc\s*20(\s+(midi|port))*(\s+\d+)?$/i
Signals
Every control publishes midi/apc20/<control> (0..1), plus /raw; pads add /hit, encoders /delta, keys /on /off and n<note>; the last control touched is midi/apc20/last.
Use it
Use AKAI Professional APC20 in your own work
Embed it with one line
No import map, no build step. Change
layout, addhardware="ask"for a Connect button.<script type="module" src="https://openaudiovisual.com/packages/midi/element.js"></script> <oav-controller profile="akai-apc20" readout></oav-controller>Or as an iframe
For places that only take an iframe. Every event arrives as a
postMessage.<iframe src="https://openaudiovisual.com/embed/controller/?profile=akai-apc20&readout" width="720" height="641" style="border:0;max-width:100%" allow="midi" title="AKAI Professional APC20"></iframe> <script> // every control the visitor plays arrives here addEventListener('message', (e) => { if (e.data?.source !== 'openav' || e.data.type !== 'control') return; console.log(e.data.detail.signal, e.data.detail.value); }); </script>Send it to Ableton, TouchDesigner or Resolume
What you play on screen leaves as real MIDI on the IAC bus (macOS) or a loopMIDI port (Windows). The steps are on the catalog page.
<!-- what you play on this controller → the IAC bus (macOS) → Ableton, TouchDesigner, Resolume --> <script type="module" src="https://openaudiovisual.com/packages/midi/element.js"></script> <oav-controller profile="akai-apc20" midi-out="IAC" readout></oav-controller> <!-- Windows: midi-out="loopMIDI" · let the visitor pick a port: midi-out="ask" -->macOS: Audio MIDI Setup → MIDI Studio → IAC Driver → “Device is online”. Windows 11: the built-in Windows MIDI Services have a loopback (not tested by us); older Windows: install loopMIDI, add a port and use
midi-out="loopMIDI".
In p5.js, with one line
The one-line injection names knobs, faders and pads by their order in this profile, the order of the table above. Add ?profile=akai-apc20 to make the on-screen controller this one; a real AKAI Professional APC20 is recognised by its port name.
document.head.prepend(Object.assign(document.createElement('script'), { src: 'https://openaudiovisual.com/p5/oav-p5.js?profile=akai-apc20' }));| In your sketch | Control | Message |
|---|---|---|
knob1 | Cue level cue-level | CC 47 · Ch 1 |
fader1 | Slider 1 slider-1 | CC 7 · Ch 1 |
fader2 | Slider Master slider-master | CC 14 · Ch 1 |
fader3 | Slider 2 slider-2 | CC 7 · Ch 2 |
fader4 | Slider 3 slider-3 | CC 7 · Ch 3 |
fader5 | Slider 4 slider-4 | CC 7 · Ch 4 |
fader6 | Slider 5 slider-5 | CC 7 · Ch 5 |
fader7 | Slider 6 slider-6 | CC 7 · Ch 6 |
fader8 | Slider 7 slider-7 | CC 7 · Ch 7 |
fader(9) | Slider 8 slider-8 | CC 7 · Ch 8 |
function draw() {
background(knob1 * 255); // Cue level · CC 47
circle(width / 2, height / 2, 50 + fader1 * 300); // Slider 1 · CC 7
}Encoders, buttons, wheels and strips are not numbered: read them as midi.cc[number] in the table above, or react in controlChange(cc, value, ch).
Other software
Use this controller outside this project
The same data, as files other programs read. Nobody has tested these on this exact unit unless the table above says so.
QLC+
An input profile: every control and LED value, for lighting. Copy it to your user folder (macOS ~/Library/Application Support/QLC+/InputProfiles, Linux ~/.qlcplus/inputprofiles, Windows %USERPROFILE%\QLC+\InputProfiles) and restart QLC+. Then set the MIDI channel of this input to Omni.
Mixxx
A starting point, not a finished mapping: decks, EQ and hot cues go to the controls in order. Put both files in the folder that Preferences → Controllers → Open User Mapping Folder opens, then remap what you like with the Learning Wizard.
The data itself
Everything above comes from this file: faceplate, messages, LEDs, SysEx and who checked what. tools/export-controller.mjs writes these files from any profile.
Missing
Is your controller not here?
Open an issue with the brand and model, whether you have the unit and a link to the manual. Or write the profile yourself: it is one JSON file.
GitHub
Is something in this data wrong?
Every number on this page comes from one JSON file. If it disagrees with your unit or the manual, tell us which firmware you checked and we fix the file.