SinuslabsSINUSLABS

VJ & DJ setup · Updated

A MIDI controller for Resolume from the gamepad you own

Resolume Avenue and Arena have no gamepad input: they take MIDI, OSC and keyboard shortcuts. PadMap closes that gap. It turns the buttons, triggers and sticks of a PlayStation, Xbox or generic controller into MIDI notes and CC on a normal MIDI port, and Resolume maps them like any pad controller. You get a wireless VJ controller you can hold while you watch the screen instead of the desk, without buying another MIDI controller for Resolume.

Short answer

Run PadMap, open Resolume's Preferences → MIDI and switch on MIDI Input for the PadMap port. Then choose Shortcuts → Edit MIDI, click a clip or parameter and press the button or move the stick you want on it. Press Escape to finish.

Set up your gamepad in Resolume

  1. 1

    Connect the controller and start PadMap

    Plug the controller in over USB or pair it over Bluetooth, then open PadMap. On macOS, PadMap creates its own MIDI port, PadMap Out. On Windows it sends through a free loopMIDI port, so create that first. Start PadMap before Resolume so the port exists when Resolume looks for MIDI devices.
    PadMap's preset menu: built-in MIDI Default, MIDI Notes and MIDI Drums presets, two saved presets and Save current as
    Built-in presets — MIDI Default, Notes and Drums — plus your own, saved with Save current as.
  2. 2

    Switch on MIDI Input for the PadMap port

    In Resolume, open Preferences and go to the MIDI tab. Find the PadMap port in the device list (PadMap Out on macOS, your loopMIDI port on Windows) and turn on MIDI Input. Unfold the MIDI monitor on the right of that tab and press a button on the pad: each message shows up as it arrives. If nothing appears, fix that before you map anything.
  3. 3

    Enter MIDI shortcut mode

    Open the Shortcuts menu and choose Edit MIDI. The interface changes colour to show that everything you can map is now waiting for a MIDI message.
  4. 4

    Click a control, then press or move the pad

    Click a clip, a layer fader, an effect parameter or a button in Resolume, then press the button or move the stick or trigger you want on it. Carry on with the next control. Each assignment is listed in the Shortcuts tab, where you select it to change how it behaves. Press Escape to leave shortcut mode.

What each control is good for in a VJ set

Buttons send notes and sticks and triggers send CC, and Resolume treats the two differently. That split maps neatly onto what a set needs:

ControlWorks well for
Face buttonsClip triggers. Four clips under your right thumb, or four columns if you map them to column triggers.
D-padMoving around the composition: next and previous column, layer select, or four more clips.
L2 / R2 triggers (LT / RT)Anything that should sit at zero until you pull it: an effect's opacity, a strobe amount, a feedback level. Release and it drops back.
Left / right stickTwo parameters per stick. X and Y on a position or scale effect lets you push the image around directly; the stick snaps back to centre when you let go.
L1 / R1 (LB / RB)Modifiers for a second PadMap layer, so the same face buttons reach another bank of clips.
Gyro (PS4 / PS5 pads)Tilt the controller to move an effect. Your thumbs stay free for clips.

Make buttons and sticks behave: shortcut options

Select a shortcut in the Shortcuts tab to see its options. The ones that matter for a gamepad:

  • Toggle flips a control on and off with each press. Piano keeps it on only while you hold the button, which is what you want for a flash, a strobe or a bypass you punch in. Invert reverses Piano.
  • For a stick or trigger, Absolute maps its full travel onto the parameter, and Range narrows that to the useful part. A stick rests in the middle, so a range that puts the middle where the parameter should rest saves you from a jump every time you touch it.
  • If a button you set to send CC in PadMap shows up without Toggle or Piano, change the shortcut's Mode to Button.
  • Shortcut Target decides whether a mapping follows a position in the composition or the selected clip or layer. By Position keeps button one on the first slot whatever clip sits there.

Resolume documents all of these in its MIDI Shortcuts article.

More clips than buttons: layers

A pad has four face buttons and a deck has many more clips. In PadMap you can stack mapping layers and make any control a modifier: hold it, and the other controls send a different set of notes and CCs.

Each layer sends its own messages, so Resolume sees a separate control for each. Map the base layer to the first four clips, hold L1 and map the same buttons to the next four. On PS4 and PS5 controllers, PadMap colour-codes the light bar to your mapping, which helps you tell at a glance what the pad is set to in a dark booth.

PadMap on layer 1, with the Create button and the light bar outline shown in the layer's purple
Each layer has its own light-bar colour. A modifier button — here Create — switches to it, held or toggled.

What PadMap does not do in Resolume

  • MIDI only. PadMap sends MIDI, not OSC. Everything Resolume lets you assign in Edit MIDI is in reach; an OSC-only workflow is not.
  • No feedback from Resolume. Resolume can send MIDI back to light the pads of a grid controller. A gamepad has no pads to light, so leave MIDI Output off for the PadMap port.

Written by Oskar Schachtschneider, who builds PadMap at Sinuslabs.

Questions

Can I use a PS5 or Xbox controller in Resolume?
Yes, through MIDI. Resolume has no gamepad input of its own, but PadMap converts the controller's buttons, triggers and sticks into MIDI notes and CC, and Resolume maps them in Shortcuts → Edit MIDI like any other MIDI controller.
Does this work in both Avenue and Arena?
Yes. MIDI shortcuts are part of both Resolume Avenue and Resolume Arena, and Resolume's MIDI documentation covers versions 6 and 7 of both.
Why doesn't the PadMap port show up in Resolume's MIDI preferences?
Start PadMap before Resolume. On Windows, make sure loopMIDI is running with a PadMap port and that the port is selected in PadMap. If Resolume was already open, restart it so it scans for MIDI devices again.
Can I use the gamepad wirelessly on stage?
Yes. PadMap works with controllers over Bluetooth as well as USB. If the connection drops in a busy room, plug the controller in with a data cable.
Does PadMap send OSC to Resolume?
No. PadMap sends MIDI notes and CC. Resolume accepts MIDI for clip triggers, layer controls and effect parameters, so most mapping needs are covered without OSC.