Fixture Builder

The Fixture Builder lets you create, edit, and import fixture profiles. Open it from Tools → Fixture Builder...

Built-in profiles

The library comes preloaded with five factory profiles, seeded into your editable library on first launch:

---

Creating a fixture from scratch

1. Click New Fixture in the Fixture Builder.
2. Enter Manufacturer and Model (both required).
3. Add one or more modes using the Add Mode button.
4. For each mode, add attributes:
   • Attribute name — type to see autocomplete suggestions for standard names (intensity, pan, tilt, zoom, iris, focus, shutter, red, green, blue, etc.), or enter a custom name.
   • Coarse channel — the DMX channel (1–512).
   • Fine channel — optional second channel for 16-bit resolution.
   • Default value — required (0–255). This is the value sent to the fixture when not actively controlled. Double-click a slider anywhere in the app to reset it to the fixture's default value.
5. Click Save to Library to make the fixture available in the patch.

At minimum, a fixture must have pan and tilt attributes with coarse channels and default values set.

Importing an existing fixture

Click Import Local... to load a fixture from a JSON file. The file must contain a valid fixture definition (see format below). The imported fixture is loaded into the editor for review and editing before saving.

Importing from GDTF

Click Import GDTF... to import a fixture from a GDTF file (.gdtf). Lumentrace reads the GDTF, maps standard attributes automatically, and loads the result into the editor. After reviewing, save to library.

Export vs Save to Library

Use Export Copy to share a profile with another machine or as a backup.

Fixture JSON format

Fixtures are stored as standard JSON. The top-level structure is:

{
  "fixtures": [
    {
      "fixture_type_id": "manufacturer_model",
      "manufacturer": "Manufacturer Name",
      "model": "Model Name",
      "modes": [
        {
          "name": "Mode Name",
          "channels": 16,
          "attributes": [
            { "attr": "pan",   "coarse": 1, "fine": 2, "default": 128 },
            { "attr": "tilt",  "coarse": 3, "fine": 4, "default": 128 },
            { "attr": "intensity", "coarse": 5, "default": 0 }
          ]
        }
      ]
    }
  ]
}

• fixture_type_id is auto-generated from manufacturer and model if not specified.
• coarse and fine are 1-based DMX channel numbers.
• default is always an 8-bit value (0–255).
• Custom attribute names must start with a letter and contain only letters, digits, underscores, or hyphens.