Skip to main content
Documentation

Library Manager

Manage your fixtures, effects, MIDI mappings, and color libraries

Library Manager

The Library Manager is your central hub for organizing and managing all reusable assets in Spectralite. Access it from the menu bar via Window > Library Manager.

Overview

The Library Manager organizes assets into five categories:

  • Fixtures - Hardware fixture definitions
  • Effects - Reusable effect presets created in the Node Editor
  • MIDI - MIDI controller mappings
  • Colors - Color palettes and gradient libraries
  • Community - Browse and download shared resources

Understanding Asset Sources

Each item shows its source with a colored indicator:

IndicatorSourceDescription
BlueProject OnlyAsset exists only in the current project
GreenLibrary OnlyAsset is saved in your global library
PurpleBothAsset exists in both project and library
OrangeInvalidAsset failed validation

Library assets are available across all your projects, while project assets are specific to the current project file.

Fixtures

Adding Fixtures to Your Project

  1. Open the Library Manager and select the Fixtures tab
  2. Browse or search for the fixture you need
  3. Click the + button to add it to your current project
  4. The fixture will now appear in your Project Fixtures panel

Importing Fixture Definitions

Spectralite uses .slf (Spectralite Fixture) files:

  1. Click the Import button in the Fixtures tab
  2. Select a .slf file from your computer
  3. Choose whether to save to library or just the current project
  4. Click Import

You can also drag and drop .slf files directly into the Library Manager.

Exporting Fixtures

To share a fixture definition:

  1. Right-click on the fixture
  2. Select Export
  3. Choose a location to save the .slf file

Effects

Saving Effects to the Library

After creating an effect in the Node Editor:

  1. Open the Library Manager and select the Effects tab
  2. Click Save Current Effect
  3. Enter a name for your effect
  4. Choose to save to library (global) or project only

Using Library Effects

  1. Find the effect you want to use
  2. Click the + button to add it to your project
  3. The effect appears in your project's effect list

MIDI Mappings

Importing MIDI Mappings

MIDI mappings (.slm files) define how controllers map to Spectralite:

  1. Select the MIDI tab
  2. Click Import
  3. Select your .slm file
  4. The mapping becomes available for use

Creating MIDI Mappings

  1. Open the MIDI Map Editor
  2. Connect your MIDI controller
  3. Map controls to functions
  4. Save the mapping to your library

Color Libraries

Color libraries (.slc files) contain collections of colors and gradients.

Using Colors from Libraries

  1. Open the Color Picker in any color parameter
  2. Select the Libraries tab
  3. Choose a library and select your color

Library Storage Location

Your global library is stored at:

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

Each asset type has its own subdirectory:

  • fixtures/ - Fixture definitions
  • effects/ - Effect presets
  • midi/ - MIDI mappings
  • colors/ - Color libraries

Tips

  • Backup your library by copying the application support folder
  • Organize fixtures by manufacturer using the search function
  • Version your effects by including version numbers in names
  • Share assets with your team by exporting and distributing files