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.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

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.
nameled-mapping-guide
descriptionVisual 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 = Off
  • 1 = On
  • 2 = 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 = Off
  • 1 = On
  • 2 = 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 });
  }
}