Code Monkey home page Code Monkey logo

homebridge-harmonyhub's Introduction

homebridge-harmonyhub

Logitech Harmony Hub plugin for Homebridge

Currently, this plugin displays Activities as switches. This way you can turn on the "Watch TV" activity by saying "Hey Siri, turn on Watch TV". You can also configure HomeKit (using an app like Insteon+) to rename the Siri command for the "Watch TV" activity to something like "TV" and put it in the "Living Room" room, that way you can say "Hey Siri, turn on the Living Room TV" and Siri will start/switch to the "Watch TV" activity.

Important 0.2.x changes

In version 0.2.x, the plugin was drastically changed to allow much better connectivity handling, faster response, simplified integration, and true multi-hub support including auto adding newly discovered hubs.

As part of this, how your activities show up in HomeKit are very different. Each hub will now properly show up as a single device in HomeKit instead of a device for each activity. That device (accessory) for the hub will contain a switch for each activity on that hub. Just like before, turning on any activity on that hub will turn off all the others and just switching off the current activity is equivalent to pressing the off button on the Harmony remote. This will drastically clean up a HomeKit for most people and makes it easier to determine which activity goes with which hub (if you have multiple).

Since multi-hub support is built right into the platform (as of this release), users who used the work around of adding the platform multiple times (with different IP address's specified) should just remove the IP addresses and go back to just one platform in your homebridge config.

In order to fix many connectivity issues, give faster responses, and add auto discovery, the discovery/connection systems wer greatly altered and integrated with one another. Given this, plus the fact that multi-hub support is built right into the platform, the ability to hard code the IP address of the hub in the config has been removed (for now). Eventually, we will likely reintegrate that feature in some way, but we will likely work on better, alternative solutions to unique cases as hard coding IP addresses is not a good long term solution. If you have one of these unique cases, feel free to write up an issue in GitHub or (preferably) submit a pull request with a better solution to your case.

Warning: when updating from 0.1.x to 0.2.x will remove any all HarmonyHub devices/activities/settings from HomeKit, replacing them with the new setup. This will NOT effect your Harmony Hubs themselves. This will NOT effect any other HomeKit/HomeBridge devices/settings/etc. The only real change is that any customizations you did to the old HarmonyHub HomeKit devices will be reset; things like renaming an activity in HomeKit (which can effect Siri), adding an activity to a room/scene, etc will be reset. All this means is that you will need to go back and redo anything customizations (reorganizing, renaming for Siri, etc) you did to HarmonyHub devices in HomeKit.

Installation

  1. Install homebridge using: npm install -g homebridge
  2. Install this plugin using: npm install -g homebridge-harmonyhub
  3. Update your configuration file. See sample config.json snippet below.

Configuration

Configuration sample:

   "platforms": [
   	{
   		"platform": "HarmonyHub",
   		"name": "Harmony Hub"
   	}
   ]

Fields:

  • "platform": Must always be "HarmonyHub" (required)
  • "name": Can be anything (used in logs)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.