tradfri-lights（特拉德弗里灯）

Tradfri Lights

Use this skill for local IKEA TRÅDFRI light control through an IKEA TRÅDFRI gateway.

Quick start

• Use scripts/tradfri.js for actual gateway actions.
• Read references/setup.md before first use to configure the gateway host and credentials.
• Install dependencies in the skill folder before first use: npm install.
• This skill depends on node-tradfri-client and a locally reachable IKEA TRÅDFRI gateway.
• Prefer exact light/group names, but the script also supports simple fuzzy matching.
• For surprising household actions, confirm first unless the user clearly asked for the action.

Commands

Run commands from the skill folder or with an absolute path.

Check connection

node scripts/tradfri.js status

List lights

node scripts/tradfri.js list-devices

List groups

node scripts/tradfri.js list-groups

Show what is on

node scripts/tradfri.js whats-on

Show offline lights

node scripts/tradfri.js offline

Turn a light on or off

node scripts/tradfri.js light-off "Speelkamer 1"
node scripts/tradfri.js light-on "Speelkamer 1"

Set brightness

node scripts/tradfri.js brightness "Speelkamer 1" 35

Turn a group on or off

node scripts/tradfri.js group-off "Woonkamer"
node scripts/tradfri.js group-on "Woonkamer"

Set group brightness

node scripts/tradfri.js group-brightness "Woonkamer" 50
node scripts/tradfri.js group-brightness "Slaapkamers" 100

Turn the main house groups all on or off

node scripts/tradfri.js all-on
node scripts/tradfri.js all-on _ 100
node scripts/tradfri.js all-off
node scripts/tradfri.js all-on _ 50 --verify

Note: SuperGroup and Instellen are intentionally excluded from bulk actions.

Control one floor

node scripts/tradfri.js floor-on 1 50 --verify
node scripts/tradfri.js floor-off 4 --verify

Apply a house layout preset

node scripts/tradfri.js layout day --verify
node scripts/tradfri.js layout evening --verify
node scripts/tradfri.js layout night --verify

Operating rules

• Match exact names first; fall back to fuzzy/partial matching only when it yields one clear result.
• If multiple likely matches exist, show candidates and ask.
• If a target is offline (alive: false), say so explicitly instead of pretending the action succeeded.
• After changing a light or group, report the exact target used.
• After smart-home actions, verify that the resulting status matches the intended outcome when practical.
• Prefer device-level verification after group actions because some gateways may report inconsistent group state.
• Keep credentials out of normal chat replies.
• Use this skill for TRÅDFRI gateway control, not HomeKit scenes.
• Ask for confirmation before large household-wide actions unless the user clearly asked for them.

Notes

• The tested route is node-tradfri-client, not pytradfri.
• Install dependencies with npm install in the skill folder. The required runtime dependency is node-tradfri-client.
• The script includes retry logic, settle delays, device-level verification, floor commands, and layout presets for installations that need more robust post-action checks.
• The gateway must be reachable on the local network from the machine running the skill.
• The script reads config from config.json, with environment variables overriding it:

- TRADFRI_HOST - TRADFRI_IDENTITY - TRADFRI_PSK

• list-devices, whats-on, and offline include the resolved group name when the gateway exposes deviceIDs on groups.
• The published version intentionally ships without working credentials; users must add their own local gateway details.
• If auth stops working, recreate credentials using the flow in references/setup.md.