TDMap is a TouchDesigner component for mapping any MIDI controller to any parameter — absolute and relative knobs, faders, buttons, push encoders, and 14-bit controls across multiple devices and banks. Plus many features you never knew you needed!
One MIDI tox to rule them all. Try it in the browser, run the 14-day trial in TouchDesigner, or sign in with Patreon or Gumroad when you're ready to step up.
No install
Browser demo
Click through the full UI with mock data, right in your browser. No download, no account, no TouchDesigner needed.
Get the actual .tox and drop it on the project root (/) in TouchDesigner — full Pro features for 14 days, no sign-in to start. The trial validates online; your MIDI mappings are kept when it ends.
Patreon — membership activates your tier (+ updates while you're a member). Gumroad — buy once, lifetime updates. Either way, the version you install keeps working if you cancel — you only need Patreon or Gumroad again to install updates or set up a new computer.
No setup wizard, no config files. Drag the .tox onto your project root (/), enable MIDI inputs in TDMap, and you can start mapping immediately.
Drag & dropTDMap.tox onto the project root (/) — suggested placement; only one instance per project
Externalize — open the TDMap COMP parameters (middle-click the TDMap button) and pulse Externalize once, before you set a TouchDesigner startup file. Saves to your palette folder for updates. Details →
Use the TDMap button in the top-right of TD's UI — click to open the web UI (Alt+Shift+D works too). All button actions →
Open the MIDI Device Manager (devices icon in the toolbar) — add your controller(s) as inputs and click Check MIDI Devices after plugging in hardware
Map something: drag a TD parameter onto the TDMap button (or onto a card in the UI) and move a knob — or pick your controller from the supported devices list to load a pre-made layout
Default shortcuts:Alt+Shift+D open UI ·
Ctrl+L Learn ·
Ctrl+Shift+L Learn (held).
All shortcuts →
Click Open the TDMap web UI
Drag Drop a TD parameter onto the button, then move a knob to map
Right-click Toggle Learn mode
Middle-click Open this component's parameters
Documentation
Guides for every workflow
Searchable docs cover setup, assigning parameters, Smart Learn, unassigned MIDI, factory presets, bulk operator assign, banks, the public Python API, and more.
In TouchDesigner, open them anytime from the ? button in the TDMap UI header.
Drag a parameter, move a knob, and you're mapped. Then layer behavior on top — across as many devices, banks, and recall scenarios as you need.
▶
Watch the full feature guide on YouTube
Deep walkthrough — mapping workflow, device layouts, banks, behaviors, Pro modes, and tips. Install is covered in Quick Start above.
Controls
Every type of MIDI control TDMap recognizes out of the box.
◎
Absolute knobs & fadersStandard 7-bit controls with full type detection via Smart Learn.
○
Relative encodersOffset-binary and two's-complement auto-classified. Adaptive or fixed step per control.
▭
14-bit faders & knobsAuto-pairs MSB+LSB, suppresses raw LSB bytes, surfaces conflicts in the UI.
Get a controller talking to TD in seconds, then refine.
⊘
No CHOPs or expressionsDrop the .tox, drag parameters, move controls — no CHOP spaghetti.
⚡
Smart LearnAuto-detects control type and MIDI protocol on the first few movements.
↔
Drag & drop everywhereAssign from any parameter chip to any target zone — cards, queue, slots, functions, piano keys. Drop a whole operator onto TDMap to bulk-fill your layout.
⊞
Multi-device & banksSeparate grids per controller; banks swap mapping sets on the same hardware.
⇄
Hardware bank syncTwo-way SysEx / CC / Note sync with multi-bank controllers — TDMap and hardware stay on the same bank.
⎘
Config libraryAny controller maps via Unassigned first. Optional factory presets (APC40, Launch Control, MiniLab, and more) when you want a head start. Full list →
Behaviors
Layer math, curves, and modes on top of any mapping.
+#
Button countStep mapped parameters on every press — clamp, loop, or zigzag through menus and numeric ranges. How it works →
λ
Button scriptsPer-slot Python on buttons and push-knobs — CHOP Execute-style callbacks, ownerComp-scoped op(), edited in the inspector. How it works →
ƒ
Function buttons ProReset, set value, bank switch via slot function, par-learn, randomize, open editor, callbacks, and more. Full function list →
◈
Parameter slots ProButtons hot-swap another control's active parameter on press — instrument-style variations.
⊛
Modifier mode ProScale, add, offset, limit, or quantize another control's output. Stackable.
Polish & workflow
Pro control-feel plus the quality-of-life details that add up.
↩
Controller undoMapped parameter moves register in TouchDesigner's undo (Ctrl+Z). An idle group window collapses each sweep into one step, not hundreds. How it works →
≈
Smoothing, pickup & easing ProFilter jitter, wait for value match on recall, 30+ response curves per control.
▤
Five view modes + multi-device viewDetailed through Values-with-bars; stack every controller in one scrollable layout.
⟳
In-place updatesCheck → install from Preferences. Configs in sibling TDMap_Config stay untouched; Base → Pro upgrades in place.
Every preference, Pro mode, and edge case is documented — including clearing mappings, 14-bit MIDI, slot mode, and button scripts.
Pick what you get — Base is full core MIDI mapping, multiple banks, hardware bank sync, and per-slot button scripts; Pro adds smoothing, pickup, easing, and the behavioral modes (functions, slots, modify). Then pick where you buy it:
Patreon — pick Base or Pro; membership activates your tier and includes updates while you're a member. Cancel anytime — the version on your machine keeps working. Gumroad — pay once; lifetime updates, up to three computers per key.
You only need Patreon or Gumroad again to install updates or set up a new computer. How licensing works · EULA
Not ready to buy? Try the whole thing free — no account needed.
Click through the UI in your browser, or run the real .tox with full Pro features for 14 days.
What's coming next — driven by patron support. Membership or a Gumroad purchase isn't just access; it funds these.
⏺
Gesture recordingCapture knob sweeps and button sequences as replayable macros — automate repetitive show cues without writing a single line of TD logic.
⇶
OSC mappingSame workflow as MIDI but over OSC — TouchOSC layouts, network-connected hardware, custom apps. Treat any OSC source as just another device in the grid.
⒮
SysExMap and trigger MIDI System Exclusive messages — patch dumps, manufacturer config, and hardware-specific protocols in the same slot grid as CCs and notes.
⌨
Keyboard shortcuts & mouse gesturesBind any TD parameter to a key chord or a mouse gesture. Useful for laptop-only workflows, demos, or any time you don't have a controller in reach.
⊜
Game controller mappingXbox / PlayStation pads and joysticks as first-class controllers — analog sticks as relative encoders, triggers as faders, buttons everywhere.
▦
Modularized action blocksChainable behavioral blocks you compose like Lego — stack modifiers, sequencers, conditions, and functions on a single control. Today's slot / modify / function modes become reusable building pieces.
Free, lighter alternatives
TDMap was inspired by community mapping tools that came first. If you want something narrower and free, check these!
