Color Palette Ref

APC Mini MK2 Color Palette Reference

Complete reference for the 128-color velocity palette and custom RGB control.

Primary Colors (Quick Reference)

Extended Color Palette

Reds (Velocity 1-8)

Oranges/Yellows (Velocity 9-16)

Greens (Velocity 17-28)

Cyans/Blues (Velocity 29-48)

Purples/Magentas (Velocity 49-64)

Brightness Control via MIDI Channel

The same velocity color appears at different brightness levels:

Example: Red at different brightness levels

output.send('noteon', { note: 0, velocity: 5, channel: 0 }); // 10% red
output.send('noteon', { note: 0, velocity: 5, channel: 3 }); // 55% red
output.send('noteon', { note: 0, velocity: 5, channel: 6 }); // 100% red

Animation Effects via MIDI Channel

Example: Pulsing red

output.send('noteon', { note: 0, velocity: 5, channel: 9 }); // Red pulse 1/4

Custom RGB via SysEx

For precise color control beyond the 128-color palette:

SysEx Message Format

F0 47 7F 4F 24 00 08 [pad] [pad] [R-MSB] [R-LSB] [G-MSB] [G-LSB] [B-MSB] [B-LSB] F7

RGB Encoding Function

function encodeRGB(value: number): [number, number] {
  // Split 8-bit value into MSB (bit 7) and LSB (bits 0-6)
  const msb = (value >> 7) & 0x01;
  const lsb = value & 0x7F;
  return [msb, lsb];
}

Complete Custom RGB Function

function setCustomRGB(
  output: Output,
  pad: number,
  r: number,
  g: number,
  b: number
) {
  const [rMSB, rLSB] = encodeRGB(r);
  const [gMSB, gLSB] = encodeRGB(g);
  const [bMSB, bLSB] = encodeRGB(b);

  output.send('sysex', [
    0xF0,                   // SysEx start
    0x47,                   // Akai manufacturer ID
    0x7F,                   // Device broadcast
    0x4F,                   // APC Mini MK2 product ID
    0x24,                   // RGB LED command
    0x00, 0x08,             // Length (8 bytes)
    pad, pad,               // Start/end pad (single pad)
    rMSB, rLSB,             // Red
    gMSB, gLSB,             // Green
    bMSB, bLSB,             // Blue
    0xF7                    // SysEx end
  ]);
}

Range RGB (Multiple Pads)

function setRangeRGB(
  output: Output,
  startPad: number,
  endPad: number,
  r: number,
  g: number,
  b: number
) {
  const [rMSB, rLSB] = encodeRGB(r);
  const [gMSB, gLSB] = encodeRGB(g);
  const [bMSB, bLSB] = encodeRGB(b);

  output.send('sysex', [
    0xF0, 0x47, 0x7F, 0x4F, 0x24,
    0x00, 0x08,
    startPad, endPad,       // Range of pads
    rMSB, rLSB,
    gMSB, gLSB,
    bMSB, bLSB,
    0xF7
  ]);
}

Common Color Examples

// Primary colors
setCustomRGB(output, 0, 255, 0, 0);     // Red
setCustomRGB(output, 1, 0, 255, 0);     // Green
setCustomRGB(output, 2, 0, 0, 255);     // Blue

// Secondary colors
setCustomRGB(output, 3, 255, 255, 0);   // Yellow
setCustomRGB(output, 4, 0, 255, 255);   // Cyan
setCustomRGB(output, 5, 255, 0, 255);   // Magenta

// Pastels
setCustomRGB(output, 6, 255, 182, 193); // Light Pink
setCustomRGB(output, 7, 173, 216, 230); // Light Blue

// Brand colors
setCustomRGB(output, 8, 29, 185, 84);   // Spotify Green
setCustomRGB(output, 9, 255, 69, 0);    // SoundCloud Orange

Peripheral Button Colors

Track and Scene buttons have fixed colors:

// Track button on
output.send('noteon', { note: 100, velocity: 1, channel: 0 });

// Scene button blinking
output.send('noteon', { note: 112, velocity: 2, channel: 0 });