DMX

DMX

govee-dmx takes the Art-Net your desk already sends and writes it to each light over LAN. Your lights become fixtures of the show.

What you need

  • A light that LAN reaches. The devices page says which models do.
  • A desk, a media server or a show application that sends Art-Net.
  • A patch file that says which light answers which channels.

Pick a channel layout

Each light answers one of three layouts. A desk calls this a personality.

Layout Channels What you get
full 6 one color for the whole light
segment 3 + 3 per zone one color per zone
pixel 3 + 3 per LED one color per LED

Channel 1 is always the dimmer, channel 2 the mode and channel 3 the white temperature, so a cue carries from one model to the next. The white covers the whole light, whatever the layout. A model serves only the layouts its hardware carries. Each model page prints its tables, channel by channel — the H61A0 is one example.

Patch a fixture

Two commands set the rig up for you.

govee-dmx patch      # find the lights and write the patch file
govee-dmx identify   # light one fixture at a time

patch looks for the lights on your network and gives each one a free start address. It leaves alone every address you already set, so you can run it again after you add a light.

identify walks the rig. It takes every fixture off, then lights them one by one and names the line of the patch file that drives each one. That is how you label the fixtures on the desk.

The first channel is always the dimmer. At 0 it powers the light off, so a blackout on the desk takes the rig down.

Run the rig

govee-dmx run        # receive Art-Net and drive the lights

run listens for Art-Net and writes each frame to the lights the patch file names. Your desk lists the node as soon as it answers a poll, and you patch it there the way you patch any other node. Add --scan to look for the lights first, so one command takes a rig from nothing to a node the desk sees.

--dry-run prints every packet and what each fixture reads out of it, and writes to no light. That is how you check a patch before the rig moves.

The run takes every light off at the start, so the rig comes up dark. A light that drops off the network stops no other one: the run reports it and carries on.