User guide
From empty rig to rolling in twelve steps.
Everything a new gaffer needs to run Gaffer Desk on set — patch, connect, light and roll.
- 01
Create a show
From the Shows page tap New show. Keep the sample rig ticked on your first try — it loads a SkyPanel, Vortex8, Orbiter, LS 600x and four Titan Tubes so you can explore every control before patching real lights.
- 02
Patch your lights
Open the Patch tab and tap Add light. Pick the brand, model and mode — the full official mode charts are built in (all 74 Creamsource Vortex modes, for example). The app shows the next free DMX address per universe, so dial that number into the fixture's menu.
- 03
Run the bridge
Browsers can't send DMX directly, so open the Bridge tab and download the Gaffer Desk Bridge. Run it on any laptop on set with plain Node (node gaffer-desk-bridge.mjs). It speaks Art-Net or sACN to your node or LumenRadio/CRMX transmitter.
- 04
Connect
On the Bridge tab, enter the bridge laptop's address and choose Art-Net or sACN. When the top bar says live, every fader move leaves the app over the network. Set sACN priority (main desk 150, backup 50) if two desks share a universe.
- 05
Control the lights
The Control tab shows a tile per light. Tap to select, then use the faders for intensity and CCT. Hold a tile for extra actions like Highlight — the light flashes full so you can find it on set.
- 06
Color, wheel & gels
The color section has three tabs: sliders for CCT/tint, a touch color Wheel for hue and saturation together, and a searchable Lee/Rosco Gel library. Tap Lee 204 Full CTO and every selected light takes that color.
- 07
Effects
Lightning, TV flicker, fire, police, paparazzi and faulty tube run in software, so they work on any fixture. The preset row above the grid gives one-tap looks — Campfire, Storm, Cop car — with tuned speed and depth.
- 08
Groups, scenes & faders
Select several lights and save them as a group for one-touch control. Save looks as scenes and fade between them. The Faders tab gives you group masters with hold-to-flash, like a real desk.
- 09
Cues
Record looks as cues in the Cues tab, set fade times and auto-follow, then fire them on action with the GO button. Undo/redo (the arrows in the top bar) covers every move.
- 10
Set plan
The Plan tab is a map of your stage. Drag each light to its real position, then switch to Control mode and tap lights by where they hang — no need to remember channel numbers.
- 11
Share the show
Tap the people button in the top bar and invite another gaffer by their Gaffer Desk email. They open the same show on their own iPad and every change syncs live both ways.
AsteraBox ART7 setup
ART7 takes DMX through a cable, not Bluetooth, so it needs a network node in front of it. Work through the checklist below before you call action.
AsteraBox ART7
Classic ART7 needs wired DMX input. Its AsteraApp Bluetooth connection is not Gaffer Desk’s TiMoTwo Bluetooth DMX connection.
- 1Gaffer DeskBrowser · computer bridge
- 2DMX network nodeArt-Net/sACN → DMX OUT
- 3ART7 adapter5-pin XLR → 3.5 mm DMX IN
- 4ART7 → Astera lightsCRMX wireless link
Quick fixes on set
- Nothing responds: Check TX mode, the CRMX link, then start DMX output.
- DMX indicator off: Gaffer Desk connected is not enough—check the node’s universe mapping and adapter.
- Wrong colors or pixels: Match the exact fixture mode and start address to Patch.
- One light missing: It may be linked to another transmitter—unlink and re-link it.
Connection checklist
0 of 6 checked · manual checks, not a connection test
Connect the network node’s DMX OUT to Astera’s 5-pin XLR adapter, then plug its 3.5 mm end into ART7’s DMX input.
- Node DMX OUT
- 5-pin XLR adapter
- ART7 3.5 mm DMX IN
Confirm: The adapter is firmly connected at both ends.
Missing a cable or DMX socket?
Use Astera’s ART7 DMX adapter and an Art-Net/sACN-to-DMX node with a physical DMX output. A normal audio cable is not a substitute. ART7’s Micro-USB only charges the box.
Charge or power ART7. Select transmitter (TX) mode using its controls and manufacturer manual.
- Power on
- TX indicator lit
Confirm: The TX indicator is on.
No power, or RX is showing?
Check the charger and battery. If RX is showing, switch to TX following the ART7 manual. The DMX indicator can stay off until you start sending in step 5.
Enable CRMX reception on your lights, then link them with ART7’s Link control according to its manual.
- CRMX on at each light
- Link confirmed
Confirm: Each light confirms its CRMX link to ART7.
A light will not link?
Move the light closer, confirm its wireless receiver is enabled, and check whether it is already linked to another transmitter. Unlink only the intended receiver using its own manual, then try again.
Match each light’s DMX mode and start address to Patch. Map the show universe to the node’s DMX output and enter the node’s IP in Gaffer Desk.
- Node IP entered
- Universe mapped
- Modes match Patch
Confirm: Protocol, universe, mode and addresses match.
Unsure which IP or universe to use?
Use the network node’s IP—not an ART7 address. Check the node’s output mapping. Gaffer Desk universe 1 may map to Art-Net 0 or 1; sACN uses the show’s universe number. Keep the node and sending device on a reachable network.
Start output in the native iPad app, or connect the computer bridge in the browser version.
- Gaffer Desk connected
- ART7 DMX indicator lit
Confirm: Gaffer Desk is connected and ART7’s DMX indicator is on.
Connected, but the DMX indicator is off?
A connected message alone does not prove DMX reception. Check the node’s input protocol, universe mapping, physical DMX output and adapter. On native iPad, allow Local Network access; in the browser, keep the computer bridge running.
Raise one light gently, check color and individual pixels if supported, then test Blackout. Keep a physical safety control available.
- One light responds
- Blackout verified
Confirm: The light responds correctly and Blackout works.
Wrong colors, no pixels, or no brightness?
Recheck the exact fixture mode and address against Patch, CRMX link, fixture level, group master, grand master and Blackout. Pixel controls need a compatible multi-pixel mode. If connection is lost, lights may hold their last look; use the physical safety control.
AsteraApp remains the tool for wireless fixture setup and battery monitoring. Direct Astera pairing and battery readback are not connected. If your label says ART7-WIFI, confirm that exact model before choosing a different connection.