Related guides: Layers, Shaders & FX (the other layers and the shared effects), Audio Setup & Beat Sync (the sound that drives the lighting) and MIDI & HID Controllers (the controller shapes).

Chapter 1: What The Layer Contains

The Lighting layer is a container with four parts. Each part has its own Visible switch and its own Opacity, and you can use any combination.

Figure 1: the Lighting tiles on the touch panel's Layers page. Lighting Layer is the container; the four tiles below it switch the parts on and off. A green tile is on.

The container has to be visible for any part to show. Its Opacity applies to everything inside it, and each part then applies its own opacity on top. In the layer stack, Lighting sits above the Vinyl Disc and below the Waveforms, Artist Card, Marquee Text and Mask layers.

Turn the layer on

• Touch panel: open Layers and tap Lighting Layer, then tap the parts you want (Spotlights, Particles, Strobes, MIDI/HID/OSC Actions).
• Settings: open Settings → Layer - Lighting and switch Visible on. Each part has its own page (Layer - Spotlights, Layer - Particles, Layer - Strobes, Layer - MIDI/HID/OSC) with its own Visible switch.
• Programming Schedule: the Lighting layer is in the list of layers a schedule row can show or hide.

Chapter 2: Before You Start: Sound

Spotlights, Particles and Strobes only react when the app is hearing sound. If the picture stays still:

1. Check the audio input as described in Audio Setup & Beat Sync.
2. Play music at show volume and make sure the level meters in the Indicators page move.

Quiet passages, breaks and silence calm the effects down; they come back with the music.

Chapter 3: Layer Settings (Settings → Layer - Lighting)

Figure 2: Settings → Layer - Lighting. Visible, Opacity, Enable Shader and the basic colour controls.

Below these, the sidebar lists extra pages with more image effects (see section 7). Size → Scale (0.1–2.0, default 1.0) enlarges or shrinks the whole layer.

Chapter 4: The Four Parts

4.1 Spotlights

Six beams of light come from the top of the picture and sweep from side to side. The beams move while there is sound; the flicker follows the sound level.

Normal	Laser
Figure 3: Normal mode — wide, soft beams.	Figure 4: Laser mode — thin lines.

Figure 5: Settings → Layer - Spotlights.

Main page

Colors page

Figure 6: each of the six beams has its own colour.

Rotation & Distance page

Beam Mode Properties page (the look of Normal mode)

Figure 7: Beam Mode Properties.

Laser Mode Properties page (the look of Laser mode)

The remaining pages of Layer - Spotlights (Color Adjustments, Color Effects, Blend/Glow, Vignette/Noise/Edge, Chromatic/Glitch/Mosaic, Kaleidoscope, Wave/Ripple, Fire/Crystalize, Electric/Fluid, Neon/DotMatrix and Scanlines/GhostTrail) are image effects that apply only to the spotlights. They are described in section 7.

4.2 Particles

Small glowing dots fall through the picture. Their colour is chosen by the part of the sound that is strongest at that moment: bass, mid or high. They are emitted only while the sound is above a low level.

Figure 8: particles with both emitters on, at full density.

Figure 9: Settings → Layer - Particles.

Colors page

4.3 MIDI/HID/OSC Actions

This part draws shapes when you press controls on a MIDI, HID or OSC controller. It is separate from the audio: nothing appears until you press a mapped control that spawns a shape.

The shapes themselves, how to map a control to a shape and the limits on how many appear at once are explained in the MIDI & HID Controllers guide.

4.4 Strobes

Four flash panels. Solid shows rectangles; Vertical Bars shows tall vertical bars across the picture.

Solid	Vertical Bars
Figure 10: Solid, with top and bottom strobes on, caught during a flash.	Figure 11: Vertical Bars, caught during a flash.

Figure 12: Settings → Layer - Strobes.

Main page

Colors page: Strobe 1 Color … Strobe 4 Color set the colour of each of the four panels. All four are white at the factory.

The top and bottom rows have their own sets of pages: Top Audio, Top Behaviors, Top FX, Top Size and the same four with Bottom. They have the same settings, so the table shows them once.

Figure 13: the Top Audio page. The Bottom pages are identical.

Chapter 5: A Look To Start With

1. Open Settings → Layer - Lighting and switch Visible on.
2. Open Layer - Spotlights, switch Visible on and choose Normal mode.
3. Open Colors and give the six beams two or three colours that match your visuals.
4. Open Layer - Particles and switch Visible on. Leave the defaults.
5. Play music. Adjust Opacity of each part until the lights support the picture instead of hiding it.
6. For big moments, switch Layer - Strobes on and use Intensity 1.0 to start with.
7. Check the result on the actual screen or projector.

Ideas

• Club look: Spotlights in Laser mode, Rotation Speed Factor 1.0, particles off, strobes on.
• Soft ambience: Spotlights in Normal mode at Intensity 0.3, Flicker off, particles on with low Density.
• Only the drop: keep only Strobes on, with Intensity 2.0 and Bottom Strobes only.

Chapter 6: Use It With The Rest Of The Show

• Touch panel: the Layers page has tiles for each part, so you can bring lights in and out live.
• Programming Schedule: a schedule row can show or hide the Lighting layer at a set time. See Programming Schedule.
• Controller: map a controller button to the layer's Visible setting or to the shape actions. See MIDI & HID Controllers.
• Other layers: Lighting sits above the Vinyl Disc and below the visualizers, so the waveforms stay readable on top of the beams.

Chapter 7: Image Effects

The same family of effects is available in three places:

The pages and their settings (range for the whole layer first; the spotlights use the same names):

Every effect is off at 0. Turn up one effect at a time; they add up, and a few together can make the picture hard to read.

Figure 14: spotlights and particles with Enable Shader off, no effects.

Figure 15: the same scene with Enable Shader on, Hue 0.55 and Kaleidoscope 0.6.

Chapter 8: Troubleshooting

Chapter 9: For Advanced Users: Configuration Keys

All settings live under elements.lightingView in the configuration. They can be changed with the HTTP API (PATCH /api/v1/config), for example:

{ "elements": { "lightingView": {
    "visible": true,
    "spotlights": { "visible": true, "spotlightMode": 0, "intensity": 0.8 },
    "particles":  { "visible": true, "bottomEmittersEnabled": true },
    "strobes":    { "visible": false }
} } }

See the HTTP & WebSocket API guide for how to read and change the configuration.