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 bridge IP or pick one from the auto-discovered list."
- **Connect Button**: click `CONNECT` to start polling the bridge."
- "Press the physical link button when ready; the dialog closes automatically as soon as the bridge confirms."
- "Use **CANCEL** only if you want to abort the pairing attempt."
- "On success, Bridge ID, name, username, and clientkey populate instantly."

## 5. Manual Credential Entry (1:45)
- "If you already have credentials or want to type them manually, click **I ALREADY HAVE THE CREDENTIALS**."
- "The hidden fields open immediately so you can paste the username and clientkey you backed up."
- "Leave the button hidden once connected—the values remain editable for future copy/paste."

## 6. Details Panel (2:10)
- **Bridge Name & ID**: stored for reference and displayed in the node label."
- **Username & Client Key**: kept in Node-RED’s encrypted credential store yet visible so you can copy them."
- **Manual Button**: disappears after a successful link, keeping the interface tidy once credentials are filled." 

## 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."
- "Copy the username and clientkey from the fields after linking and store them securely."

## 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!"