External control
DMX and Art-Net
Control Live Alchemy from a lighting desk over Art-Net, sACN or USB DMX.
Settings → DMX lets a lighting desk run Live Alchemy over Art-Net, sACN or USB DMX. This is control input only; laser output goes through DACs.
Adding DMX inputs
- Under DMX Inputs, choose the Adapter the desk's network is on.
- Press Add ArtNet Input (port 6454), Add sACN Input (port 5568) or Add USB DMX Input.
- Open the input in Active DMX Inputs: and check its status line counts packets.
- USB DMX: pick the interface, Refresh to rescan.
- Universes are numbered as they travel: Art-Net from 0, sACN from 1, USB DMX is universe 0. Many desks call Art-Net universe 0 "universe 1".
- sACN multicast reaches Live Alchemy on universes 1–16.
Patch Live Alchemy on your console
Live Alchemy can be patched as a fixture, like a moving light. Its Intensity channel is the fixture's dimmer, so the desk's grand master and blackout dim the laser output.
- Download the fixture file for your desk (see the table below).
- Import it on the desk and patch one Live Alchemy fixture in Compact (32 channels) or Extended (128 channels) mode. Note its universe and address.
- In Live Alchemy, add the DMX input the desk sends on.
- In Active Profile:, choose Console fixture – Compact (32 ch) or Console fixture – Extended (128 ch), the same mode as on the desk.
- Set Universe: and Start address: to where the fixture is patched. The line beside them shows the channels it takes.
- Raise the fixture's intensity on the desk.
Compact has the masters, tempo, page and cue pad selectors, transport, the Clockworks source selector and cue pads 1–16. Extended adds cue pads 17–40, all 48 shortcuts, User 1–3, tempo nudge, show time and the Clockworks lane faders; its first 32 channels are the Compact mode. Every channel is listed in DMX fixture channels.
| Console | File | How to import |
|---|---|---|
| grandMA3 | GDTF | Copy it to grandMA3/gma3_library/fixturetypes on a USB stick. Menu → Patch → Fixture Types → Import, choose the stick, select the file, Import. |
| grandMA2 | Compact or Extended XML | Copy it to gma2/library on a USB stick. Setup → Patch & Fixture Schedule, add fixtures, then at the fixture type choose From Library → Select Drive, pick the file and import it. |
| ChamSys MagicQ (1.8.4.4 and later) | GDTF | Put it in show/heads (or on a USB stick). Setup → File Manager, select the file, choose the modes, then PATCH IT. |
| ETC Eos family (3.2.4 and later) | GDTF | Browser → File → Import → GDTF Fixtures, from a USB stick. |
| Avolites Titan (17 and later) | GDTF or D4 | Open the GDTF in Personality Builder (file type GDTF Personality) and save it, or take the D4 as it is. Copy the personality to the user personalities folder (D:\Personalities on a console, Documents\Titan\Personalities for Titan PC) and restart Titan. |
| QLC+ | QXF | Copy it to the user fixtures folder (macOS ~/Library/Application Support/QLC+/Fixtures, Windows C:\Users\YourName\QLC+\Fixtures, Linux ~/.qlcplus/Fixtures) and restart QLC+. It is listed under Laserworks. |
| Hog 4, Obsidian ONYX, Chauvet ShowXpress, Wolfmix, Lightkey and others | Channel chart (CSV) | Build a fixture in the desk's fixture editor (Hog Fixture Builder, ONYX Fixture Library Editor…) from the chart. |
DMX mapping profiles
- Active Profile:, New, Save; Profile directory: shows where profiles are.
- A mapping turns a channel into a command.
- Universe: and Start address: move the whole profile on the desk's universes, for any profile.
- Mappings lists each mapped channel, where the desk sends it, and the control it runs. Delete removes one at once.
- Channels are numbered as on the desk, 1 to 512.
The Default DMX Profile uses universe 0:
| Channels | Control |
|---|---|
| 1–8 | Cue pads 1–8 (top row) |
| 11 | Master Intensity |
| 12, 13 | X and Y position |
| 14 | Size |
| 15 | Rotation |
| 21 | BPM (20–300) |
| 31 | Blackout |
| 41–46 | Clockworks lane faders 1–6 |
Learning Mode
Learning Mode maps a desk channel to a control, without editing the profile file.
- In Active Profile:, choose the profile to add to.
- In Control:, choose what the channel should run. For pads and lanes, set the number next to it.
- Tick Learning Mode.
- On the desk, move one fader or press one button.
The mapping appears under Mappings and is saved in the profile straight away.
- After a cue pad or shortcut button, learning moves on to the next one: press the next desk button. Untick Learning Mode when you are done.
- After any other control, learning stops and the channel works at once.
- If the channel already ran something, the new control replaces it. A control you learn again leaves its old channel. The line under Learning Mode names what was replaced.
- Move only one channel at a time. If a desk cue moves several channels, nothing is learned.
- A channel below the profile's Universe: or Start address: can't be learned into it.
| Control | How the channel acts |
|---|---|
| Cue pad 1–40 | A button for that pad on the current page, counted left to right, then down |
| Shortcut button 1–48 | A button for that shortcut pad |
| Master slider … | A fader over the slider's whole range |
| Mixer blend | A fader; full travel commits the blend |
| BPM | A fader from 20 to 300 BPM |
| Tap tempo, Nudge tempo up, Nudge tempo down, Ending, Blackout, Stop all cues, Next page, Previous page, Show time play/pause | Fires once each time the channel goes past half-way |
| Clockworks lane fader 1–6 | A fader for the lane's manual opacity |
A button presses its pad when the channel goes past half-way and releases it when the channel drops back.
DMX statistics
- Total Inputs:, Total Universes:, Active Mappings: confirm the desk is reaching Live Alchemy.
Art-Net timecode
- See Timecode.
Troubleshooting DMX
| Problem | Check |
|---|---|
| Nothing happens | The input's status line counts packets; the adapter; the firewall; another program on port 6454 |
| Some channels do nothing | Universe: and Start address: match the desk's patch; the profile's mode matches the desk's mode |
| Laser output dark with the fixture patched | The fixture's intensity on the desk, and the desk's grand master |
| Pads retrigger | A button channel sits near half-way |
| The tempo jumps when the desk starts | The fixture's BPM channel is above 19; set it to 0 to leave the tempo to Live Alchemy |