README.md

Homebridge Harmony TV

Creates a HomeKit TV accessory for a Logitech Harmony-controlled TV.

Update 2020-12-22

This project is no longer maintained. Consider trying nicoduj/homebridge-harmony which, at the time of writing, is verified and actively maintained.

Update 2019-09-12

I don’t use a Logitech Harmony Hub anymore, and I’m unlikely to undertake any new development on this plugin in the near future. For now, new patch versions will continue to be published automatically when this plugin’s depedencies are updated. Please open an issue if you are interested in maintaining this plugin.

Use Case

The target use case of this plugin is “control a non-smart TV in HomeKit via a Harmony Hub”, not “use HomeKit as an interface for all Harmony features”. If you’d like Harmony Activites to show up as inputs in HomeKit, check out the homebridge-harmony plugin.

Installation

Review the Installation section of the Homebridge README.

npm install --global homebridge-harmony-tv-smockle

Setup

1. Find the static IP address of your Harmony Hub. In the plugin configuration, this is the "host" value.

2. Run npx [email protected] $HOST, if you don’t include globally-installed packages in $PATH) to find the unique identifier of your Harmony Hub. In the plugin configuration, this is the "remoteId" value.

3. Run npx [email protected] $HOST $REMOTE_ID, if you don’t include globally-installed packages in $PATH) to find the unique identifier of the Harmony Hub-connected TV you want to control. In the plugin configuration, this is the "deviceId" value.

Configuration

{
  "bridge": {
    "name": "Homebridge Harmony TV",
    "username": "CC:22:3D:E3:CE:30",
    "port": 51826,
    "pin": "031-45-154"
  },
  "description": "Homebridge Harmony TV",
  "accessories": [],
  "platforms": [{
    "platform": "HarmonyTV",
    "name": "Living Room TV",
    "host": "192.168.1.10",
    "remoteId": "22571993",
    "deviceId": "72306838"
  }]
}

Notes:

• "platform" must be "HarmonyTV"
• "name" values must be unique

Useful Links

• Homebridge Developer Documentation for Television Service
• Homebridge Example Independent Platform Plugin
• Node.JS HAP TV Accessory Docs
• Node.JS HAP TV Accessory Example