gitwtfhub

wtf is akai-apc-mini-td-interface?

lex-zander/akai-apc-mini-td-interface — explained in plain English

Analysis updated 2026-05-18

0Audience · designerComplexity · 2/5Setup · easy

TL;DR

A drag-and-drop TouchDesigner component that emulates a full AKAI APC Mini MIDI controller on screen, matching the real hardware exactly.

Mindmap

mindmap
  root((APC Mini Emulator))
    What it does
      Emulates AKAI APC Mini
      Runs inside TouchDesigner
      Matches real hardware layout
    Tech stack
      TouchDesigner
      MIDI CHOP
    Use cases
      Prototype MIDI mappings
      Test before buying hardware
      Drive live visuals
    Audience
      Visual artists
      TouchDesigner creators
      MIDI performers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Prototype a TouchDesigner MIDI control layout without owning the physical APC Mini

REASON 2

Test pad, button, and fader mappings before wiring up a real Ableton or TouchDesigner show

REASON 3

Build a live visual performance setup driven by simulated APC Mini input

REASON 4

Swap in the real APC Mini hardware later using the same channel names

What's in the stack?

TouchDesignerMIDI

How it stacks up

lex-zander/akai-apc-mini-td-interface00kaku/gallery-slider-block04amanrajj/netwatch
Stars00
LanguageJavaScriptRust
Last pushed2021-05-19
MaintenanceDormant
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencedesignergeneralops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires TouchDesigner 2023.x or newer, works in the free non-commercial edition.

Wtf does this do

akai-apc-mini-td-interface is a component for TouchDesigner, a visual programming tool used for interactive media and installations, that emulates an entire AKAI APC Mini mk1 MIDI controller on screen. Instead of needing the physical hardware, a creator can build and test their project against this on screen version, then swap in the real controller later since the layout matches exactly. The component reproduces every physical control: the 8 by 8 grid of pads, 16 round buttons, a Shift button, and 9 faders. Each control behaves like the real hardware, so clicking a pad or dragging a fader on screen produces the same kind of signal a real APC Mini would send. Output values are normalized between 0 and 1 by default, matching how TouchDesigner's built in MIDI input tool reads a real APC Mini, though a raw 0 to 127 mode is also available. A deliberate design choice gives every control a readable, friendly name such as pad1, trackVolume, or faderMaster, rather than exposing raw MIDI note and CC numbers directly. The exact MIDI mapping behind each friendly name is documented in the readme and stored inside the component's configuration table, so someone can later build a small renaming layer to make a real hardware MIDI input use the same naming convention. Other built in options include a toggle mode that makes pads latch on or off instead of only responding while held, adjustable colors and sizing for the interface, and a label system that lets a user attach their own custom text labels to any pad, button, or fader, which then get saved automatically inside the TouchDesigner project file. Installation is a matter of dragging the provided file into a TouchDesigner project or saving it to a shared palette for reuse. It requires TouchDesigner 2023 or newer and works in the free, non commercial edition since it does not depend on any paid only features. The project is offered free of charge, with an optional donation link for anyone who wants to support the author.

Yoink these prompts

Prompt 1
Help me install this AKAI APC Mini emulator component into my TouchDesigner project
Prompt 2
Explain how to rename the emulator's MIDI channels to match a real APC Mini In CHOP
Prompt 3
Show me how to enable toggle mode so pads latch on and off in this component
Prompt 4
Walk me through adding custom labels to the pads and faders in this TouchDesigner component

Frequently asked questions

wtf is akai-apc-mini-td-interface?

A drag-and-drop TouchDesigner component that emulates a full AKAI APC Mini MIDI controller on screen, matching the real hardware exactly.

How hard is akai-apc-mini-td-interface to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is akai-apc-mini-td-interface for?

Mainly designer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.