Harmony hub support for Homey
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github/ISSUE_TEMPLATE
assets
drivers/harmony_device_driver
lib
locales
node_modules
.gitignore
LICENSE
README.md
app.js
app.json
package.json

README.md

Homey Harmony Hub App

At the moment this project supports:

  • Pairing of devices connected to the harmony hub
  • A mobile card supporting the power toggle functionality of the device
  • An action card for sending a specific command to the Harmony device using homey flows and how many times this command needs to be repeated.
  • Action cards for starting/stopping a hub activity
  • Condition card to check if device is/isn't turned on
  • Condition card to compare if a specific activity has been started.
  • Trigger cards for device is turned on/off
  • Trigger cards for activity is starting/started/stopped
  • Trigger card for inactivity
  • Syncing the device onoff state based on the current hub activity
  • Picking up activity changes from external sources (e.g. the Logitech Harmony Remote)

Donations

If you like the work on this project please consider a donation. Of course, this is optional and you should in no way feel obligated to send a donation. The donations will be spent on buying a second Harmony Hub to support me testing a multi-hub situation.

Setup

Once the app is installed you can pair a device that is connected to the harmony hub:

-1- Click on the plus on the homey Zones & Devices screen to add devices

Adding a device

-2- Select homey harmony hub

Select homey harmony hub

-3- Select the hub you want to start pairing on

Select harmony hub for pairing

-4- Select all devices you want to pair

Select devices for pairing

-5- Your devices are now paired

Devices paired

Setting up triggers

The following triggers are supported by this app:

  • Activity started
  • Activity stopped
  • Device turned on
  • Device turned off

Activity started

To use this trigger drag the Homey Harmony Hub from the apps section to the when column Activity started setup

This trigger exposes 2 tokens hub and activity. The hub token reports the hub name an activity was triggered on. The activity token reports the activity name an activity was triggered on.

Activity stopped

To use this trigger drag the Homey Harmony Hub from the apps section to the when column Activity stopped setup

This trigger exposes 2 tokens hub and activity. The hub token reports the hub name an activity was triggered on. The activity token reports the activity name an activity was triggered on.

Device turned on

To use this triggegr drag the paired device from the devices section to the when column. Device turned on

This trigger exposes 1 token hub. The hub token reports the hub name an activity was triggered on.

Device turned off

To use this triggegr drag the paired device from the devices section to the when column. Device turned off

This trigger exposes 1 token hub. The hub token reports the hub name an activity was triggered on.

Setting up actions

The following actions are supported by this app:

  • Start activity
  • Stop activity
  • Send command to device

Start activity

To use this action drag the Homey Harmony Hub from the apps section to the then column Start activity

Now specify the Harmony Hub on which you want to start your activity Start activity specify hub

After you specified the hub you can select the activity you want to start Start activity specify activity

Stop activity

To use this action drag the Homey Harmony Hub from the apps section to the then column Stop activity

Now specify the Harmony Hub on which you want to stop your activity Stop activity specify hub

Send command to device

To use this triggegr drag the paired device from the devices section to the then column. Send command to device

Now specify the control group your command is in Send command to device specify control group

After you specified the control group you can select the command you want to send to the selected device Send command to device specify command

Future releases

At the moment there is no real roadmap but for the upcoming release you can expect the following:

  • ...... create an issue on Github with a Feature request label an who knows your feature will be in the next release!

What does this app track?

This app uses Application Insights to track the following topics:

  • Application errors, which help to solve issues
  • Unknown device types, so I can add more icons in future releases, making it easier to find the device you are looking for in the Homey flow editor.

The information gathered is for debugging purposes only at no time will it be used for tracking personal information.

Contributing to this project

If you want to be a contributor for this project, you are very welcome!

Contact information

If you want to contact me the best way is joining the athomcommunity on slack and send a direct message to @jreenen.

Versioning

This app uses semantic versioning

  • MAJOR version when you make incompatible API changes,
  • MINOR version when you add functionality in a backwards-compatible manner, and
  • PATCH version when you make backwards-compatible bug fixes.

For a detailed desceiption you can find the documentation for semantic versioning here

Version history

v1.3.0

Added starting activity trigger to be informed an activity is about to start. Added a repeat argument to the send command action (e.g. for adjusting the volume by more than just one step). Added an inactivity trigger to be informed when the hub is being inactive for a specified period. Added a activity comparing condition

A special thanks to @denniedegroot who added on/off functionality for smart home devices and will help me on this project whenever time allows him to.

v1.2.1

Instead of always using the power toggle command use the power on and power off when they are available and fallback to the power toggle command when they are not available. This solves an issue with devices that don't support the power toggle command

Fixed an issue where on powering off an activity, an activity started trigger got raised on the previous activity instead of an activity stopped trigger.

v1.2.0

For improved stability and future features, a new connection library has been written for the Homey Harmony App.

If an activity has been started/stopped by an external source (e.g. the Logitech Harmony Remote), the app picks up on this event and updates the device states accordingly and triggers the applicable flow cards.

You can now use a flow condition card for your device to check if it is/isn't turned on.

v1.1.1

Hotfix release, some users experiencing an error "Error: MAX_CLIENTS=6"

v1.1.0

Pairing of devices connected to the harmony hub A mobile card supporting the power toggle functionality of the device An action card for sending a specific command to the Harmony device using homey flows. Action cards for starting/stopping a hub activity Trigger cards for device is turned on/off Trigger cards for activity is started/stopped Syncing the device on-off state based on the current hub activity

v1.0.0

Initial release (never hit the Athom store)

Used external library's

swissmanu's harmonyhubjs-discover