VDMX5 Gamepad VJ Control with a DualSense MIDI Bridge

VDMX is the macOS VJ tool of choice for people who like their software opinionated and their workspace customisable down to the panel. It also speaks MIDI fluently — which means you don't need a $400 controller to drive it. A DualSense, a free virtual MIDI port, and the bridge get you to a workable VDMX gamepad MIDI rig in under ten minutes. This post walks the setup, the mapping, and the tricks for live use.

Why a gamepad for VDMX5

VDMX is designed to be picked up by a touch screen, a MIDI controller, an OSC stream, or all three. The friction point is owning a tactile controller in the first place. Most VJs already own a DualSense — sixteen physical inputs, two analog sticks, two analog triggers, a touchpad, motion. Universal Controller MIDI bridges the HID layer into a virtual MIDI port VDMX picks up as a native source. No loopback hacks, no IAC headaches beyond switching it on.

What you'll need

• Universal Controller MIDI v1.0+ (download)
• VDMX5 b8.+ (vidvox.net)
• DualSense, DualShock 4, or Xbox Series controller
• macOS 12+ — VDMX is macOS-only
• A USB-C cable that handles data

Setup

1. Bridge the gamepad to virtual MIDI

Launch the bridge, plug the controller in. macOS-side, open Audio MIDI Setup, then Window → Show MIDI Studio. Double-click the IAC Driver node, tick Device is online. That gives the bridge a system bus to publish onto. The bridge's status pill should now read UCMIDI port online.

2. Add the bridge as a MIDI source in VDMX

In VDMX open Workspace Inspector → MIDI. Tick Universal Controller MIDI in the input list. You should immediately see activity in the MIDI monitor as you wiggle sticks. If you don't, restart VDMX — it enumerates MIDI sources on launch.

3. Bind controls via Receive MIDI

Right-click any UI slider, button, or fader. Pick Receive MIDI → Auto. Wiggle the input you want. VDMX captures the note or CC and binds it. Repeat for every control you want under your thumbs.

4. Wire buttons into the Cues plugin

Add the Cues plugin to your workspace. Each cue row has a Trigger column — right-click, Receive MIDI, then press the gamepad button. Cross fires cue 1, Circle cue 2, and so on.

Mapping ideas

• Face buttons → cue triggers. Cross, Circle, Square, Triangle drive the first row of cues.
• Right stick → master crossfade. CC 5 on the X axis is a no-look crossfade between A and B decks.
• Left stick → 2D FX target. Drop a Quartz Composer FX or ISF filter that takes XY and bind the stick.
• Triggers → opacity per layer. L2 = layer A opacity, R2 = layer B opacity. Analog the whole way.
• Touchpad → XY effect pad. Touchpad X on CC 16, Y on CC 17, both routed into a multi-axis ISF filter.
• D-pad → preset bank nav. Up/down step through Workspace Presets, left/right step through cue banks.

Performance tips

• Enable 14-bit CC on sticks. In the bridge Settings → 14-bit CC, then in VDMX's MIDI binding pick 14-bit Range. Sweeps stop laddering.
• Smooth incoming CCs. VDMX has a per-binding Smoothing slider in Receive MIDI → Settings. Drop it to 30–60 ms for stick CCs.
• Use workspace MIDI mapping over plugin-level. Bind at the workspace level so it travels with you when you reorganise UI panels.
• USB-C for shows. Bluetooth 5.0 is great for the couch. In a venue with 200 phones it isn't.

Gotchas

• VDMX doesn't see the source. Restart VDMX after enabling the IAC bus and the bridge. MIDI source enumeration is launch-time.
• Sticks centre at 64. That is normal MIDI. Use VDMX's binding Min/Max to map 0–127 → your slider range, with a tight deadzone around 64.
• Cue triggers double-fire. You probably bound both note-on and note-off. In Receive MIDI → Settings switch Trigger Mode to On Press.
• Touchpad jumps to 0 when you lift. Set the bridge's Touchpad → Hold last value to On so VDMX keeps the last position instead of snapping back.

Wrap

VDMX plus a DualSense is the smallest-form-factor VJ rig you can build that still feels professional. Map once, save the workspace, you're done. Pair it with the touchpad XY guide for the Kaoss-pad move that nobody else in the lineup will have. The full VDMX documentation covers the rest of the workspace side.

Try Universal Controller MIDI against your existing VDMX workspace tonight — it works with the free tier, Pro unlocks the preset editor and every connector.