0.1.1 • Published 5 years ago

homebridge-harmony-tv v0.1.1

Weekly downloads
4
License
MIT
Repository
github
Last release
5 years ago

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

KeyDescriptionDefault
accessoryMust be HarmonyTVN/A
nameName to appear in the Home appN/A
connectionMust be http (for now)http

httpSettings block (mandatory when connection = http)

KeyDescriptionDefault
apiIPIP address of Harmony API serverN/A
apiPortPort of Harmony API server8282
pollingIntervalTime (in ms) between status checks5000
timeOutTime (in ms) until the accessory will be marked as Not Responding5000

MQTT block (mandatory when connection = mqtt)

Todo

Additional fields

KeyDescriptionDefault
model (optional)Appears under the Model field for the accessoryHarmony TV
serial (optional)Appears under the Serial field for the accessoryHarmony TV
manufacturer (optional)Appears under the Manufacturer field for the accessorygoedh452

Config sample

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