Skip to main content
Documentation
Panels

MIDI Map Editor Panel

Create and edit MIDI controller mappings

MIDI Map Editor Panel

The MIDI Map Editor lets you create mappings between MIDI controllers and Spectralite parameters.

Interface

Mapping List

Shows all current mappings:

  • Control - MIDI input (CC, Note, etc.)
  • Target - Spectralite parameter
  • Range - Value range
  • Mode - Mapping behavior

Toolbar

  • Add - Create new mapping
  • Delete - Remove selected mapping
  • Learn - Auto-detect MIDI input
  • Test - Verify mapping works

Creating Mappings

MIDI Learn

The easiest way to create mappings:

  1. Click Learn
  2. Move a control on your MIDI device
  3. Spectralite captures the MIDI message
  4. Select the target parameter
  5. Adjust options as needed

Manual Entry

For precise control:

  1. Click Add
  2. Enter MIDI details:
    • Type - CC, Note, Pitch Bend
    • Channel - 1-16
    • Number - CC number or note
  3. Select target parameter
  4. Set value range

Mapping Targets

Parameters

Map to any node parameter:

  1. Select Parameter as target type
  2. Browse or search for the parameter
  3. The parameter updates when MIDI changes

Transport

Control playback:

  • Play/Pause
  • Stop
  • Tap Tempo
  • BPM (use CC for variable)

Layer Control

Per-layer mappings:

  • Opacity - Fade layers
  • Solo - Toggle solo
  • Mute - Toggle mute

Master

Global controls:

  • Master Dimmer
  • Blackout
  • Flash

Mapping Options

Range

Scale MIDI values to parameter range:

  • Input Range - MIDI values to use (0-127)
  • Output Range - Parameter values to produce
  • Invert by swapping min/max

Mode

How the mapping behaves:

ModeBehavior
AbsoluteValue matches position
RelativeChange adds/subtracts
ToggleButton toggles on/off
MomentaryActive while held

Curve

Response curve for the mapping:

  • Linear - Direct correspondence
  • Exponential - Slow start, fast end
  • Logarithmic - Fast start, slow end
  • S-Curve - Gradual at extremes

Organizing Mappings

Groups

Create groups for organization:

  1. Select mappings
  2. Right-click, Create Group
  3. Name the group
  4. Collapse/expand as needed

Pages

For controllers with limited controls:

  1. Create multiple mapping pages
  2. Switch pages during performance
  3. Each page has independent mappings

Saving and Loading

Save Map

  1. File > Save MIDI Map
  2. Name your map
  3. Saved as .slm file

Load Map

  1. File > Load MIDI Map
  2. Select .slm file
  3. Mappings are applied

Default Map

Set a map to load with projects:

  1. Save your map
  2. Go to Settings > MIDI
  3. Select as default map

Testing

Input Monitor

View incoming MIDI:

  1. Enable Show Input
  2. Move controls on your device
  3. See MIDI messages in real-time

Mapping Highlight

When a mapped control moves:

  • The mapping highlights in the list
  • The target parameter flashes
  • Verify connection is working

Troubleshooting

MIDI not detected

  • Check device connection
  • Verify in MIDI Devices panel
  • Check MIDI channel settings

Wrong parameter changing

  • Review the mapping target
  • Check for duplicate mappings
  • Verify MIDI channel

Values jumping

  • Use Relative mode for encoders
  • Check for CC conflicts
  • Verify range settings