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:
- Click Learn
- Move a control on your MIDI device
- Spectralite captures the MIDI message
- Select the target parameter
- Adjust options as needed
Manual Entry
For precise control:
- Click Add
- Enter MIDI details:
- Type - CC, Note, Pitch Bend
- Channel - 1-16
- Number - CC number or note
- Select target parameter
- Set value range
Mapping Targets
Parameters
Map to any node parameter:
- Select Parameter as target type
- Browse or search for the parameter
- 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:
| Mode | Behavior |
|---|---|
| Absolute | Value matches position |
| Relative | Change adds/subtracts |
| Toggle | Button toggles on/off |
| Momentary | Active 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:
- Select mappings
- Right-click, Create Group
- Name the group
- Collapse/expand as needed
Pages
For controllers with limited controls:
- Create multiple mapping pages
- Switch pages during performance
- Each page has independent mappings
Saving and Loading
Save Map
- File > Save MIDI Map
- Name your map
- Saved as .slm file
Load Map
- File > Load MIDI Map
- Select .slm file
- Mappings are applied
Default Map
Set a map to load with projects:
- Save your map
- Go to Settings > MIDI
- Select as default map
Testing
Input Monitor
View incoming MIDI:
- Enable Show Input
- Move controls on your device
- 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
Related Panels
- MIDI Devices - Device connections
- Parameters - Parameter targets