MIDI
Input: (multiple devices supported)
Output: (multiple devices supported)
Virtual MIDI Setup
To route MIDI between Spectra and your DAW, use a virtual MIDI driver:
- Windows: loopMIDI (free)
- macOS: IAC Driver (built-in) - enable in Audio MIDI Setup
- Linux: ALSA virtual ports or JACK
SysEx Message Format (for developers)
Spectra uses manufacturer ID 0x7D (non-commercial/educational).
Microtonal Note (12 bytes)
F0 7D 01 [trk] [note] [vel] [pitL] [pitH] [sign] [partial] [amp] F7
- 01 = Note message type
- trk = Track index (0-127)
- note = Nearest MIDI note (0-127)
- vel = Velocity (0-127, 0 = note off)
- pitL/pitH = 14-bit pitch deviation in decicents (0.1¢ resolution, ±1638.3¢ range)
- sign = 0 = positive, 1 = negative deviation
- partial = Partial number (1-127)
- amp = Amplitude (0-127)
Panic / All Notes Off (12 bytes)
F0 7D 02 00 00 00 00 00 00 00 00 F7
02 = Panic message type
Transport Sync (12 bytes)
F0 7D 03 [time0] [time1] [time2] [time3] [flags] 00 00 00 F7 (Start)
F0 7D 04 [time0] [time1] [time2] [time3] [flags] 00 00 00 F7 (Stop)
- 03 = Transport Start, 04 = Transport Stop
- time0-3 = 28-bit time in milliseconds (max ~74.5 hours)
- flags = Reserved for future use
OSC
Network Discovery
Devices
Input: (receive OSC from)
Output: (send OSC to)
Delete this device?
OSC Address Reference
Incoming (to Spectra on port 9002):
/spectra/note/on pitch velocity [track]
/spectra/note/off pitch [track]
/spectra/transport/* (play, stop, position)
Outgoing (from Spectra):
/spectra/note/on track partial frequency velocity amplitude
/spectra/note/off track partial frequency
/spectra/transport/start playing(1/0)
/spectra/transport/position position
/spectra/transport/loop position
Add OSC Device
Spectra receives OSC on port 9002
Transport Sync
External Control:
Responds to: Play, Stop, Continue, Song Position Pointer
Output Filter
Track Filter:
Partial Filter:
Spatial Output Routing
API
Coming Soon
This section is reserved for custom scripts and API integration.
Tuning Editor
Type:
Number of Divisions:
Reference A4 (Hz):
Analyze an audio file to extract frequencies and create a tuning from them.
Fine-tune Notes (cents offset)
Timbre Editor
| # | Mult | Amp |
|---|
Reserved for objects, effects, generators.
Grid Editor
Grid Type:
Exponent: (If negative, uses 1/|x|)
Defaults
Default Tuning:Default Grid:
Data
Playback mode: cursor reset / continuous
Audio
Compensates for audio output delay. Increase if sound plays after the playhead passes notes. Click Auto to measure, or set manually (typically 50-200ms).
MIDI Input
MIDI note that maps to the tuning root. Default 69 (A4). Set to 60 for C-centered mapping.
Partial Editing
Maximum partial number when navigating partials. Requires Ordered Partials Selection (bottom-right radio buttons) to be enabled. Affects up/down keys, scroll mode dragging, and MIDI partial mode.