yungsters / homebridge-harmony

Harmony websocket plugin for homebridge

homebridge-harmony

Logitech Harmony plugin for HomeBridge using WebSockets.

Work In Progress

List of known issues:

• If you change activities too quickly, some unexpected behavior might occur
• Still verbose on logs, for debugging purpose
• No dynamic discovery of the hub(s)

Installation

1. Install Homebridge using: npm install -g homebridge
2. Install this plugin using: npm install -g homebridge-harmony
3. Update your Homebridge config.json using the sample below.

Configuration

"platforms": [
  {
    "platform": "HarmonyHubWebSocket",
    "name": "NicoHarmonyHub2",
    "hubIP": "192.168.1.42",
    "showTurnOffActivity" : true,
    "turnOffActivityName" : "HC Off"
  }
]

Fields:

• platform must be "HarmonyHubWebSocket" (required).
• name is the name of the published accessory (required).
  • Use a different name for each entry if you have multiple hubs (source).
• hubIP is the static IP address of the hub (required). A static IP address is required.
• showTurnOffActivity configures whether to publish a "switch" accessory to turn off every activity (defaults to false).
  • The "switch" will be "on" if and only if there is no current activity, and toggling it while "on" does nothing.
• turnOffActivityName customizes the name of the "switch" enabled by showTurnOffActivity (defaults to "PowerOff").

Changelog

• 0.0.6
  • [BREAKING] platform was renamed to HarmonyHubWebSocket to avoid conflicts with previous plugins commonly used.
  • [NEW] introduces retry mechanism if error codes 202 / 100 returns by hub while starting an activity
  • [UPDATE] updates node dependency to 6.0.0 and homebridge to 0.4.21
• 0.0.3
  • [BREAKING] TurnOffActivityName was renamed to turnOffActivityName.

Inspiration

Thanks to iandday/pyharmony/pyharmony/client.py for the Harmoney WebSocket protocol implementation.