Philips-Hue-TouchDesigner-DMX

Art-Net DMX → Hue Entertainment v2 bridge. Receives Art-Net over UDP from TouchDesigner, forwards as DTLS stream to a Philips Hue bridge.

Requirements

• Python 3.12 (see .python-version)
• uv
• A Philips Hue bridge with an Entertainment configuration, plus credentials (username, clientkey, app id, entertainment RID)

Run

uv run --frozen main.py

Edit the HUE_* constants at the top of main.py with your bridge identity and auth before running.

Configuration

All constants live at the top of main.py:

• HUE_BRIDGE_IP, HUE_BRIDGE_ID, HUE_SWVERSION, HUE_USERNAME, HUE_CLIENTKEY, HUE_APP_ID, HUE_ENTERTAINMENT_RID — bridge identity + auth.
• ARTNET_PORT (6454), ARTNET_UNIVERSE (0) — Art-Net listener.
• MAX_SEND_HZ (50) — Hue Entertainment caps near 50 Hz; raising risks frame drops.
• CHANNEL_MAP — DMX byte index → Hue channel_id. Default = 9 channels at stride 3 (RGB).

Alpine Linux

hue-entertainment-pykit builds native crypto bindings. On Alpine, install these apk packages first:

apk add gcc musl-dev libffi-dev openssl-dev python3-dev cmake mbedtls2-dev