This software allows you to program your Logitech Harmony remote using a
configuration object retreived from the harmony website:
  http://members.harmonyremote.com/

The website is required. The website is required in Logitech's software as
well, it's just that their software wraps the website. Their website has
all the logic on what codes work with what remotes and what hardware, etc.
The software just takes the binary blobs that the website makes and writes
it to the remote control. This is true for both Logitech's software and
this software.

However, this software has some extra functionality such as being able to
dump (backup) your existing config, being cross-platform, and giving you
extra visibility into what's actually happening with your remote.

Here is how you use this software:

0. I got a file from the website, do something useful with it.

  $ sudo concordance <filename>

This will attempt to figure out what to do, and do it. Note that concordance
uses the *filename* to figure out what to do with it, so don't rename it. This
option is designed for associating the .EZHex extension in your browser with
the concordance software. Of course, this requires your desktop environment to
support someway of getting concordance root access such as gksu or similar, but
should allow the same seemless process the Logitech software does. If you
would prefer to rename it, tell concordance what you need done using one of it's
many options...

1. Backup the config

  $ sudo concordance --dump-config=/tmp/config.EZHex

This will read the config off of your remote and write it to /tmp/config.EZHex.
It's a good tool for development as well as backing up your config. This can
however be created from the members.harmonyremote.com website. The equals
is needed if you pass in a filename since the filename is optional. If
you don't specify, concordance will use 'config.EZHex' in the current directory.

2. Connectivity test

  $ sudo concordance --connectivity-test Connectivity.EZHex

The site will always do a connectivity test before trying to send a config,
so be prepared to do this before next step.

3. Write a config

Once you have downloaded a file from members.harmonyremote.com website to
program your remote with, you can use it with:

  $ sudo concordance --write-config Update.EZHex

4. Backup the firmware

  $ sudo concordance --dump-firmware

This will read the firmware off of your remote and write it to fimrware.EZHex.
See "1. Backup the config" for more information.

5. Write firmware

NOTE: THIS IS NOT YET SUPPORTED. However it would work like this:

  $ sudo concordance --write-firmware Firmware.EZHex


There are other options - check out the --help one!


THIS SOFTWARE IS NOT SUPPORTED BY OR IN ANY WAY RELATED TO LOGITECH!


- Phil Dibowitz

