@harmonyhub/client is a Node.JS library which allows you to interact with your Logitech Harmony Hub.
Last updated a year ago by airborne04 .
ISC · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @harmonyhub/client 
SYNC missed versions from official npm registry.

Client Package (Deprecated in favour of client-ws)

@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.


npm install @harmonyhub/client


Enhancements over the harmonyhubjs-client package are the following

  • added typings to the harmonyhub response data for easing development with typescript
  • 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


import { getHarmonyClient } from '@harmonyhub/client';

async function run(): Promise<void> {
  const harmonyClient = await getHarmonyClient('');

  const encodedAction = `{"command"::"VolumeUp","type"::"IRCommand","deviceId"::"27633596"}`;
  const dt_press = `action=${encodedAction}:status=press`;
  const dt_release = `action=${encodedAction}:status=release`;

  try {
    const commands = await harmonyClient.getAvailableCommands();
    console.log('commands', commands);
    await harmonyClient.send('holdAction', dt_press);
    await harmonyClient.send('holdAction', dt_release);
  } catch(error) {
    console.error('Error', error.message);

  err => console.log(err)

This example connects to a Harmony hub available on the IP 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 example.js

Current Tags

  • 1.0.8                                ...           latest (a year ago)

9 Versions

  • 1.0.8                                ...           a year ago
  • 1.0.7                                ...           a year ago
  • 1.0.6                                ...           a year ago
  • 1.0.5                                ...           2 years ago
  • 1.0.4                                ...           2 years ago
  • 1.0.3                                ...           2 years ago
  • 1.0.2                                ...           2 years ago
  • 1.0.1                                ...           2 years ago
  • 1.0.0                                ...           2 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 10
Last Month 11
Dependencies (5)
Dev Dependencies (2)

Copyright 2014 - 2017 © taobao.org |