---

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

Copy┌─────────────────────────────────────────────────────┐
│                                                     │
│  [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:

Coordinate Conversion Functions

Copy// 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:

Velocity values:

• 0 = Off
• 1 = On
• 2 = Blink

Scene Launch Buttons (Notes 112-119)

Right column, single-color green LEDs:

Velocity values:

• 0 = Off
• 1 = On
• 2 = Blink

Special Buttons

LED Types by Region

Common Patterns

Light entire row

Copyfunction 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

Copyfunction 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

Copyfunction 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

Copyfunction clearAllPads(output: Output) {
  for (let note = 0; note < 64; note++) {
    output.send('noteon', { note, velocity: 0, channel: 0 });
  }
}