node-red-contrib-knx-ultimate/tutorial/hue-config.md

Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control and ETS group address importer. Easy to use and highly configurable.

# hue-config Node – Tutorial Outline

## 1. Intro (0:00)
- "Welcome! We’re configuring the `hue-config` node, the bridge connection used by all Philips Hue companion nodes in the KNX Ultimate suite."
- "We’ll connect to the bridge, register an API user, and review how to manage credentials securely."

## 2. Prerequisites (0:20)
- "Hue bridge reachable on your network."
- "KNX Ultimate gateway already added (required for HTTPS proxying during registration)."
- "Access to the physical link button on the bridge."

## 3. Opening the Config Node (0:40)
- "From any Hue device node, open the Server dropdown and click the pencil icon."
- "You’ll see the `hue-config` dialog with Connect button, details panel, and credential controls."

## 4. Connection Workflow (1:00)
- **Host**: enter the IP address of the Hue bridge."
- **Connect Button**: click `CONNECT` to query bridge information."
- "The node prompts you to press the physical link button, then it completes registration via the gateway’s REST helper."
- "On success, Bridge ID, name, username, and clientkey populate automatically."

## 5. Manual Credential Entry (1:45)
- "If automatic registration fails, choose **Set credentials manually** from the dialog."
- "Enter the API username and clientkey obtained from the Hue developer portal or backup."
- "Use the `Reveal Bridge Secrets` button later to copy credentials if needed."

## 6. Details Panel (2:10)
- **Bridge Name & ID**: stored for reference and displayed in the node label."
- **Username & Client Key**: held in Node-RED credentials storage (encrypted)."
- **Test Link**: optional link to the Hue documentation embedded in the UI."

## 7. Status Feedback (2:35)
- "Success shows the details area. Errors trigger modals (bad IP, link button not pressed, missing KNX gateway)."
- "The waiting spinner appears during registration—don’t close the dialog until it completes."

## 8. Tips & Best Practices (2:55)
- "Reserve a static IP for the bridge to avoid broken connections."
- "Use the same `hue-config` node for all Hue devices to share credentials."
- "Rename the config node for easier identification when multiple bridges exist."
- "Back up the username and clientkey using the reveal button after linking."

## 9. Wrap-Up & CTA (3:25)
- "We linked the Hue bridge, generated credentials, and reviewed manual fallback options."
- "Like, subscribe, and comment if you want more Hue and KNX integrations!"