@harmonyhub/client

Client Package

@harmonyhub/client is a package of the harmonyhub library for interacting with a Logitech Harmony Hub.

It is based upon @swissmanu harmonyhubjs-client Which was based upon @jterraces awesome Harmony protocol guide. harmonyhubjs-client provides an extended protocol guide for the interested ones.

Installation

npm install @harmonyhub/client --save

Enhancements

Enhancements over the harmonyhubjs-client package are the following

• rewrite to class style
• replacement of Q library with native nodejs Promises (dep reduction) also means that if you switch from harmonyhubjs-client package to mine you need to adjust how you are dealing with your promises (switch to official spec)
• update of dependencies to newer packages (0 security issues by npm audit)
• incorporation of @patters bug fix of MAX_CLIENTS=6 error

## Usage

var harmony = require('@harmonyhub/client').getHarmonyClient;

harmony('192.168.1.200')
  .then(function(harmonyClient) {
    harmonyClient.isOff()
      .then(function(off) {
        if(off) {
          console.log('Currently off. Turning TV on.');

          harmonyClient.getActivities()
            .then(function(activities) {
              activities.some(function(activity) {
                if(activity.label === 'Watch TV') {
                  var id = activity.id
                  harmonyClient.startActivity(id)
                  harmonyClient.end()
                  return true
                }
                return false
              })
            });
        } else {
          console.log('Currently on. Turning TV off');
          harmonyClient.turnOff();
          harmonyClient.end();
        }
      })
  });

This example connects to a Harmony hub available on the IP 192.168.1.200. As soon as the the connection is established, isOff() checks if the equipment is turned off. If off, the activity with the name Watch TV is started. If on, all devices are turned off.

Debug Traces

@harmonyhub/client uses debug for generating traces throughout its execution time. Activate them by setting the DEBUG environment variable:

$ DEBUG=harmonyhub:client* node myharmonyjsapp.js