Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

Python library for programmatically using a Logitech Harmony Link or Ultimate Hub.

Project Description

Python library for programmatically using a Logitech Harmony Link or Ultimate Hub.

A fork of [bkanuka/pyharmony]( with the intent to:
- Make pip/ installable.
- Unify improvments made in other forks.
- Configurable for Harmony Link/Hub differences.
- Better practices for project layout.
- Better error handling!
- Inclusion into Home Assistant (


As the harmony protocol is being worked out, notes are in


* Authentication to Logitech's web service working.
* Authentication to harmony device working.
* Querying for entire device information
* Querying for activity information only
* Querying for current activity
* Starting Activity
* Sending Command


Pyharmony - Harmony device control

usage: harmony [-h] --harmony_ip HARMONY_IP [--harmony_port HARMONY_PORT]

Pyharmony - Harmony device control

positional arguments:
show_config Print the Harmony device configuration.
Print the current activity config.
start_activity Switch to a different activity.
power_off Stop the activity.
sync Sync the harmony.
send_command Send a simple command.

optional arguments:
-h, --help show this help message and exit
--harmony_port HARMONY_PORT
Network port that the Harmony is listening on.
(default: 5222)
Logging level to print to the console. (default: INFO)

required arguments:
--harmony_ip HARMONY_IP
IP Address of the Harmony device. (default: None)


* Figure out how to detect when the session token expires so we can get a new
* Figure out a good way of sending commands based on sync state.
* Is it possible to update device configuration?
Release History

Release History

This version
History Node


History Node


Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting