Skip to main content
Documentation

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
  • Position map layouts
  • BPM and timing settings

Usage:

  • Save: Project > Save project (Cmd + S)
  • Open: Project > Load 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 input settings
  • 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 gradient definitions
  • Gradients with multiple stops
  • Active color selections

Usage:

  • Managed via the Color Libraries dialog (Color Settings panel > Open Library)
  • Import via Library Manager

Import and Export

Importing Assets

  1. Open Project > Library Manager
  2. Select the appropriate tab
  3. Click Import
  4. Select the file
  5. Choose destination (Library or Project)

Exporting Assets

  1. Right-click on any asset
  2. Select Export
  3. Choose save location

File Storage Locations

Library Assets

PlatformLocation
macOS~/Library/Application Support/spectralite/
Windows%APPDATA%\spectralite\
Linux~/.config/spectralite/

Subdirectories:

  • default-fixtures/ - .slf files
  • default-effects/ - .sle files
  • default-midi-mappings/ - .slm files
  • default-color-libraries/ - .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 TypeTypical 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