File Formats
Reference for Spectralite file types and project files
File Formats
Spectralite uses several file formats for storing projects, fixtures, effects, and other assets.
Project Files
Spectralite Project (.slp)
The main project file containing your complete show.
Contains:
- Timeline with all layers
- Effect assignments
- Fixture patch configuration
- Pixel map layouts
- BPM and timing settings
Usage:
- Save: File > Save Project (Cmd + S)
- Open: File > Open Project (Cmd + O)
Asset Files
Fixture Definition (.slf)
Defines a lighting fixture's DMX channel layout and capabilities.
Contains:
- Fixture name and manufacturer
- DMX channel definitions
- Channel types (color, dimmer, position)
- Multiple mode configurations
Usage:
- Import via Library Manager > Fixtures > Import
- Export by right-clicking a fixture > Export
Effect Preset (.sle)
Saves a complete node graph as a reusable effect.
Contains:
- All nodes in the effect
- Node connections
- Parameter values
- Exposed parameters
Usage:
- Save via Library Manager > Effects > Save Current Effect
- Import via Library Manager > Effects > Import
MIDI Mapping (.slm)
Stores MIDI controller mappings.
Contains:
- MIDI CC/Note assignments
- Target parameters
- Value ranges and curves
- Channel assignments
Usage:
- Create in MIDI Map Editor
- Import via Library Manager > MIDI > Import
Color Library (.slc)
Collection of colors and gradients.
Contains:
- Named colors with RGB values
- Gradients with multiple stops
- Category organization
Usage:
- Import via Library Manager > Colors > Import
- Access in Color Picker > Libraries tab
Import and Export
Importing Assets
- Open Window > Library Manager
- Select the appropriate tab
- Click Import
- Select the file
- Choose destination (Library or Project)
Exporting Assets
- Right-click on any asset
- Select Export
- Choose save location
File Storage Locations
Library Assets
| Platform | Location |
|---|---|
| macOS | ~/Library/Application Support/spectralite/ |
| Windows | %APPDATA%\spectralite\ |
| Linux | ~/.config/spectralite/ |
Subdirectories:
fixtures/- .slf fileseffects/- .sle filesmidi/- .slm filescolors/- .slc files
Compatibility
Cross-Platform
All Spectralite file formats are cross-platform:
- Files created on macOS work on Windows/Linux
- No conversion needed between platforms
Technical Details
File Format Specifications
All Spectralite asset files are JSON-based:
- UTF-8 encoding
- Human-readable
- Can be version-controlled with Git
File Size Guidelines
| File Type | Typical Size |
|---|---|
| .slf (Fixture) | 1-50 KB |
| .sle (Effect) | 5-200 KB |
| .slm (MIDI) | 1-20 KB |
| .slc (Colors) | 1-10 KB |
| .slp (Project) | 50 KB - 5 MB |