apc-mini-tools

APC Mini MK2 Claude Plugin

Claude Code plugin for Akai APC Mini MK2 MIDI controller development.

Overview

This plugin provides comprehensive support for developing applications that control the APC Mini MK2's RGB LEDs and handle button/fader inputs using TypeScript and Node.js.

Installation

claude plugin add naporin0624/claude-plugin-apc-mini

Plugin Structure

.claude-plugin/
  plugin.json          # Plugin manifest
  marketplace.json     # Marketplace metadata

skills/
  midi-protocol-lookup/  # MIDI protocol reference
  led-mapping-guide/     # Button/LED mapping
  color-palette-ref/     # Color palette & RGB
  apc-code-samples/      # Code examples

agents/
  apc-developer.md      # Development specialist agent

reports/
  apc-mini-led.md       # Original research document

Skills

Skill	Purpose
midi-protocol-lookup	MIDI note numbers, channels, velocity values
led-mapping-guide	Visual button/LED layout, coordinate conversion
color-palette-ref	128-color palette, custom RGB via SysEx
apc-code-samples	TypeScript implementation examples

Agent

• apc-developer: Specialized agent for APC Mini MK2 development tasks. Expert in MIDI protocol, LED control, and TypeScript implementation.

Quick Reference

Recommended Libraries

• easymidi: Rapid prototyping, object-based API
• @julusian/midi: Production use, prebuilt binaries

Key Note Ranges

Component	Notes
Pad Grid	0-63
Track Buttons	100-107
Scene Buttons	112-119
Shift	122
Faders (CC)	48-56

MIDI Channels

Channel	Effect
0-6	Solid brightness (10%-100%)
7-10	Pulse animation
11-15	Blink animation

Primary Colors (Velocity)

Color	Velocity
Off	0
White	3
Red	5
Orange	9
Yellow	13
Green	21
Cyan	33
Blue	45
Purple	49
Magenta	53

Development Commands

# Install dependencies
npm install easymidi
# or
npm install @julusian/midi

# List MIDI devices
npx ts-node -e "import e from 'easymidi'; console.log(e.getInputs(), e.getOutputs())"

Contributing

See reports/apc-mini-led.md for the original research documentation.

License

MIT