Skip to main content
Documentation

Set Up MIDI Control

Map your controller to Spectralite

Hardware MIDI controllers can adjust parameters, trigger effects, and drive a live performance. You wire a controller's knobs, faders, and buttons to Spectralite actions in the MIDI Input dialog.

Connect your controller

  1. Plug the controller into your computer over USB.
  2. Open Edit > Inputs > MIDI.
  3. The controller appears in the Devices list on the left. If it's missing, click Reload devices.

The MIDI Input dialog: devices and mappings on the left, a mapping's assignment table on the right

Create a mapping

A mapping is a named group of assignments. You pick one mapping per device, and it decides how that device's controls drive Spectralite.

  1. Under Mappings, click Add mapping and name it.
  2. Select the mapping to open its assignment table on the right.
  3. Click Add assignment. The dialog listens for the most recent MIDI message.
  4. Move a knob, fader, or button. Its MIDI type, channel, and controller number appear.
  5. Click Apply to use those values, or type them in by hand.
  6. Pick an action type and target: layer opacity, BPM, a parameter value, and so on.
  7. Click Submit. The assignment goes live immediately.

Back in the Devices list, choose the new mapping from the dropdown next to the controller. A device can have only one active mapping at a time.

Common mappings

ControlMaps well to
FadersLayer opacity, master dimmer
KnobsEffect speed, color parameters
ButtonsLayer solo, effect triggers
PadsTap tempo, layer activation

Keep separate mappings per show or controller layout, and save them to the Library Manager to reuse across projects. Put the parameters you reach for most on the controls you can reach fastest.