led-mapping-guide
Visual guide for APC Mini MK2 LED and button mapping. Use when user needs to know "which button", "pad location", "LED position", "coordinate to note", "note to coordinate", or wants to understand the physical layout of the controller.
When & Why to Use This Skill
The APC Mini MK2 LED Mapping Guide is a comprehensive technical reference for developers and music producers working with the Akai APC Mini MK2 MIDI controller. It provides an interactive visual map of the 8x8 RGB pad grid, MIDI note assignments for all physical buttons, and ready-to-use TypeScript functions for coordinate-to-note conversion, streamlining the process of building custom MIDI scripts and hardware integrations.
Use Cases
- Custom MIDI Scripting: Quickly identify MIDI note numbers (0-127) for pads, track buttons, and scene launchers when writing custom controller scripts for DAWs like Ableton Live or Bitwig.
- Dynamic LED Programming: Use the provided coordinate conversion logic to program complex visual animations or real-time feedback on the 8x8 RGB grid based on X/Y coordinates.
- Hardware Integration & Debugging: Reference the physical layout and LED type specifications (RGB vs. Single Color) to troubleshoot communication between software and the APC Mini MK2 hardware.
- Live Performance Mapping: Efficiently map faders (CC48-CC56) and special function buttons like Shift (Note 122) for specialized live performance setups without manual trial and error.
| name | led-mapping-guide |
|---|---|
| description | Visual guide for APC Mini MK2 LED and button mapping. Use when user needs to know "which button", "pad location", "LED position", "coordinate to note", "note to coordinate", or wants to understand the physical layout of the controller. |
APC Mini MK2 LED Mapping Guide
Visual reference for button positions and their corresponding MIDI note numbers.
Physical Layout Overview
┌─────────────────────────────────────────────────────┐
│ │
│ [SHIFT] [SCENE 1-8] │
│ 112-119 │
│ ┌───┬───┬───┬───┬───┬───┬───┬───┐ ┌───┐ │
│ │56 │57 │58 │59 │60 │61 │62 │63 │ │112│ Row 8 │
│ ├───┼───┼───┼───┼───┼───┼───┼───┤ ├───┤ │
│ │48 │49 │50 │51 │52 │53 │54 │55 │ │113│ Row 7 │
│ ├───┼───┼───┼───┼───┼───┼───┼───┤ ├───┤ │
│ │40 │41 │42 │43 │44 │45 │46 │47 │ │114│ Row 6 │
│ ├───┼───┼───┼───┼───┼───┼───┼───┤ ├───┤ │
│ │32 │33 │34 │35 │36 │37 │38 │39 │ │115│ Row 5 │
│ ├───┼───┼───┼───┼───┼───┼───┼───┤ ├───┤ │
│ │24 │25 │26 │27 │28 │29 │30 │31 │ │116│ Row 4 │
│ ├───┼───┼───┼───┼───┼───┼───┼───┤ ├───┤ │
│ │16 │17 │18 │19 │20 │21 │22 │23 │ │117│ Row 3 │
│ ├───┼───┼───┼───┼───┼───┼───┼───┤ ├───┤ │
│ │ 8 │ 9 │10 │11 │12 │13 │14 │15 │ │118│ Row 2 │
│ ├───┼───┼───┼───┼───┼───┼───┼───┤ ├───┤ │
│ │ 0 │ 1 │ 2 │ 3 │ 4 │ 5 │ 6 │ 7 │ │119│ Row 1 │
│ └───┴───┴───┴───┴───┴───┴───┴───┘ └───┘ │
│ C1 C2 C3 C4 C5 C6 C7 C8 │
│ │
│ ┌───┬───┬───┬───┬───┬───┬───┬───┐ │
│ │100│101│102│103│104│105│106│107│ [TRACK 1-8] │
│ └───┴───┴───┴───┴───┴───┴───┴───┘ │
│ │
│ ════════════════════════════════ [FADERS 1-9] │
│ F1 F2 F3 F4 F5 F6 F7 F8 F9(Master) │
│ CC48 CC49 CC50 CC51 CC52 CC53 CC54 CC55 CC56 │
│ │
└─────────────────────────────────────────────────────┘
Pad Grid Mapping (Notes 0-63)
8x8 RGB pad matrix with full color support:
| Row | Col 1 | Col 2 | Col 3 | Col 4 | Col 5 | Col 6 | Col 7 | Col 8 |
|---|---|---|---|---|---|---|---|---|
| 8 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 |
| 7 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 |
| 6 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 |
| 5 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 |
| 4 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 |
| 3 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 |
| 2 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 |
| 1 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 |
Coordinate Conversion Functions
// Convert (row, column) to MIDI note (1-indexed coordinates)
function coordToNote(row: number, col: number): number {
return (row - 1) * 8 + (col - 1);
}
// Convert MIDI note to (row, column) (1-indexed)
function noteToCoord(note: number): { row: number; col: number } {
return {
row: Math.floor(note / 8) + 1,
col: (note % 8) + 1
};
}
// Convert (x, y) to MIDI note (0-indexed coordinates)
function xyToNote(x: number, y: number): number {
return y * 8 + x;
}
// Convert MIDI note to (x, y) (0-indexed)
function noteToXY(note: number): { x: number; y: number } {
return {
x: note % 8,
y: Math.floor(note / 8)
};
}
Track Buttons (Notes 100-107)
Bottom row, single-color red LEDs:
| Button | Track 1 | Track 2 | Track 3 | Track 4 | Track 5 | Track 6 | Track 7 | Track 8 |
|---|---|---|---|---|---|---|---|---|
| Note | 100 | 101 | 102 | 103 | 104 | 105 | 106 | 107 |
| Hex | 0x64 | 0x65 | 0x66 | 0x67 | 0x68 | 0x69 | 0x6A | 0x6B |
Velocity values:
0= Off1= On2= Blink
Scene Launch Buttons (Notes 112-119)
Right column, single-color green LEDs:
| Button | Scene 1 | Scene 2 | Scene 3 | Scene 4 | Scene 5 | Scene 6 | Scene 7 | Scene 8 |
|---|---|---|---|---|---|---|---|---|
| Note | 112 | 113 | 114 | 115 | 116 | 117 | 118 | 119 |
| Hex | 0x70 | 0x71 | 0x72 | 0x73 | 0x74 | 0x75 | 0x76 | 0x77 |
| Row | 8 | 7 | 6 | 5 | 4 | 3 | 2 | 1 |
Velocity values:
0= Off1= On2= Blink
Special Buttons
| Button | Note | Hex | LED |
|---|---|---|---|
| Shift | 122 | 0x7A | None |
LED Types by Region
| Region | Notes | LED Type | Colors |
|---|---|---|---|
| Pad Grid | 0-63 | RGB | 128 palette + custom RGB |
| Track | 100-107 | Single | Red only |
| Scene | 112-119 | Single | Green only |
Common Patterns
Light entire row
function lightRow(output: Output, row: number, velocity: number) {
for (let col = 0; col < 8; col++) {
const note = (row - 1) * 8 + col;
output.send('noteon', { note, velocity, channel: 6 });
}
}
Light entire column
function lightColumn(output: Output, col: number, velocity: number) {
for (let row = 0; row < 8; row++) {
const note = row * 8 + (col - 1);
output.send('noteon', { note, velocity, channel: 6 });
}
}
Light diagonal
function lightDiagonal(output: Output, velocity: number) {
for (let i = 0; i < 8; i++) {
const note = i * 8 + i;
output.send('noteon', { note, velocity, channel: 6 });
}
}
Clear all pads
function clearAllPads(output: Output) {
for (let note = 0; note < 64; note++) {
output.send('noteon', { note, velocity: 0, channel: 0 });
}
}