FOR TOUCHDESIGNER

MIDI mapping,
without the wiring.

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!

Download TDMap → Open Live Demo →

Free download · 7-day Pro trial
Drop-in .tox at /
TouchDesigner 2023.12120+ 2025.32460+ for optimized 14-bit

TDMap web UI — multi-device MIDI mapping grid with device tabs, banks, and slot inspector

Try it free. Own it for good.

One MIDI tox to rule them all. Try it in the browser, run the 7-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.

Open the demo →

Free · 7 days

Download & trial

Get the actual .tox and drop it on the project root (/) in TouchDesigner — full Pro features for 7 days, no sign-in to start. The trial validates online; your MIDI mappings are kept when it ends.

Download TDMap →

Own it

Patreon or Gumroad

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.

See tiers & pricing →

Drop it in. Start mapping.

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 & drop TDMap.tox onto the project root (/) — suggested placement; only one instance per project
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

What's in TDMap.

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.

■

Buttons & push-knobsGate, latch, trigger hardware — mapping intent (toggle, momentary, pulse) independent of hardware.

Mapping

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.

⊞

Multi-device & banksSeparate grids per controller; banks swap mapping sets on the same hardware (Pro).

⎘

Config libraryFactory presets, saved layouts, global configs — mappings live outside the component and survive updates.

Behaviors

Layer math, curves, and modes on top of any mapping.

Function buttonsReset, bank switch, par-learn, randomize, open editor, callbacks, and more. Full function list →

◈

Parameter slotsButtons hot-swap another control's active parameter on press — instrument-style variations.

⊛

Modifier modeScale, add, offset, limit, or quantize another control's output. Stackable.

Polish & workflow

Pro control-feel plus the quality-of-life details that add up.

≈

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.

Button function tables, every preference, keyboard shortcuts, and the public script API are in the reference docs.

Full reference →

Two tiers. Buy on Patreon or Gumroad.

Pick what you get — Base is full core MIDI mapping; Pro adds banks, 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 five 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 7 days.

Open browser demo → Download + 7-day Pro trial →

Base

Core mapping

Everything you need to map a controller and ship a show.

✓Multi-device — separate grids and channel IDs per controller
✓Smart Learn — auto-detect control type and MIDI protocol on first movements
✓Drag & drop — assign parameters to slots; single or multi-assignment
✓All control types — absolute & relative knobs/faders, 14-bit, buttons, push-knobs
✓Button actions — toggle, momentary, pulse, set-max
✓Velocity & keyboard — pads drive parameters via velocity; bind pars to piano keys
✓Hover mode — slot drives whatever parameter your cursor is over in TD
✓Range, clamp & default — per-assignment min/max and default overrides
✓Relative steps — adaptive or fixed encoder stepping; global default + per-slot override
✓Config library — device layouts and factory presets; mappings survive updates

Patreon · Base tier → Buy once · Gumroad

Membership funds updates. Your installed copy keeps working if you cancel.

Preview Base in the browser demo →

Pro

Everything in Base, plus behavior.

Layer math, curves, and modes on top of any mapping.

✓Multiple banks — swap mapping sets on the same hardware; bank shortcuts & bank functions
✓Filter (smoothing) — exponential glue on parameter changes; global or per-slot
✓Pickup mode — absolute controls wait to match current value before adjusting
✓Easing curves — 30+ functions, per-knob or per-parameter override
✓Function mode — reset, set value, bank switch, par learn, randomize, callbacks, and more. Full function list →
✓Slot mode (◈) — buttons & push-knobs hot-swap another slot's active parameter
✓Modify mode (⊛) — scale, add, offset, limit, or quantize another control's output
✓Alternate Knob — push-knob encoder flips between two assignments on hold/toggle

Patreon · Pro tier → Buy once · Gumroad

Membership funds updates. Your installed copy keeps working if you cancel.

Preview Pro in the browser demo →

On the roadmap.

What's coming next — driven by patron support. Membership or a Gumroad purchase isn't just access; it funds these.

⏺

Gesture recording Capture knob sweeps and button sequences as replayable macros — automate repetitive show cues without writing a single line of TD logic.

⇶

OSC mapping Same workflow as MIDI but over OSC — TouchOSC layouts, network-connected hardware, custom apps. Treat any OSC source as just another device in the grid.

⌨

Keyboard shortcuts & mouse gestures Bind 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 mapping Xbox / PlayStation pads and joysticks as first-class controllers — analog sticks as relative encoders, triggers as faders, buttons everywhere.

▦

Modularized action blocks Chainable 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.

Map something.

Try the full UI in your browser — no TouchDesigner required — or download the real component and run it free for 7 days with every Pro feature on.

Download TDMap → Open the Live Demo →

MIDI mapping,without the wiring.