pyharmony's Introduction

pyharmony

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

A fork of bkanuka/pyharmony with the intent to:

Make pip/setup.py 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 (https://home-assistant.io)

Protocol

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

Status

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

Usage

Pyharmony - Harmony device control

usage: harmony [-h] (--harmony_ip HARMONY_IP | --discover)
               [--harmony_port HARMONY_PORT]
               [--loglevel {CRITICAL,ERROR,DEBUG,WARNING,INFO}]
               {show_config,show_current_activity,start_activity,power_off,sync,send_command}
               ...

Pyharmony - Harmony device control

positional arguments:
  {show_config,show_current_activity,start_activity,power_off,sync,send_command}
    show_config         Print the Harmony device configuration.
    show_current_activity
                        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)
  --loglevel {CRITICAL,ERROR,DEBUG,WARNING,INFO}
                        Logging level to print to the console. (default: INFO)

required arguments:
  --harmony_ip HARMONY_IP
                        IP Address of the Harmony device. (default: None)
  OR
  --discover
                        Run a network scan to discover hubs

TODO

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

Recommend Projects