homebridge-harmony-tv

hombridge-harmony-tv is a plugin for Homebridge which allows you to control your activities of your Harmony remote. It creates a Homekit television with inputs that represent the activities.

Features

• HomeKit TV integration
• HomeKit automation
• Turn activity on/off
• Choose activity from the input list

To use the plugin iOS 12.2 or higher is required.

Todo

• MQTT support for harmony API

Installation

For this plugin to work, enable XMPP for the Harmony hub and install the Harmony API:

Enable XMPP:

• Open the Harmony app
• Go to Harmony setup
• Add/change devices and activities
• Remote and Hub
• Enable XMPP
• Confirm twice

Install Harmony API (with great thanks to maddox)

cd $HOME
git clone https://github.com/maddox/harmony-api.git
cd harmony-api
script/bootstrap

Install Harmony API as a service

sudo mkdir -p /var/lib/harmony-api
sudo cp -R * /var/lib/harmony-api
sudo ln -sf /var/lib/harmony-api/config /etc/harmony-api
sudo cp /var/lib/harmony-api/config/harmony-api-server.service /etc/systemd/system/
sudo systemctl enable harmony-api-server.service

Then either reboot or run

sudo systemctl start harmony-api-server.service

Harmony API server log is checked with

sudo journalctl -f -u harmony-api-server

Install homebridge-harmony-tv:

sudo npm install -g homebridge-harmony-tv

Configuration

Add the accessory in config.json. The hub will be detected automatically and add the activities.

Core

Key	Description	Default
accessory	Must be HarmonyTV	N/A
name	Name to appear in the Home app	N/A
connection	Must be http (for now)	http

httpSettings block (mandatory when connection = http)

Key	Description	Default
apiIP	IP address of Harmony API server	N/A
apiPort	Port of Harmony API server	8282
pollingInterval	Time (in ms) between status checks	5000
timeOut	Time (in ms) until the accessory will be marked as Not Responding	5000

MQTT block (mandatory when connection = mqtt)

Todo

Additional fields

Key	Description	Default
model (optional)	Appears under the Model field for the accessory	Harmony TV
serial (optional)	Appears under the Serial field for the accessory	Harmony TV
manufacturer (optional)	Appears under the Manufacturer field for the accessory	goedh452

Config sample

"accessories": [
 {
   "accessory": "HarmonyTV",
   "name": "Televisie WK-Achter",
   "connection": "http",
   "httpSettings":{
                   "apiIP": "192.168.1.100",
                   "apiPort": 8282,
                   "pollingInterval": 5000,
                   "timeout": 5000
                 }
   }
 ]