clarijs/remote2integrationharmony repository overview

⁠Remote 2 Integration for Logitech Harmony Hub

This integration will make devices and activities from one (or more) Logitech Harmony Hub(s) available on one (or more) UC Remote 2. The integration will try to detect the Hubs on the local network. If not detected you can add them manually (during setup). For all devices and activities the Harmony Hub settings (icons, favorites, button mappings) will copied. For each hub all activities are copied to one group (so only one harmony activity of a hub can be active).

The integration will try to keep in sync with the hubs. So you can combine the original Logitech remote together with Remote 2!

After setup you can customize everything to your needs. You can use activities and devices in other activities to your liking.

See https://youtu.be/Fne3kIkJm7w⁠ for setup and result after setup

⁠Docker Installation

Docker image will run rootless. (assign group 'users' (USER_UID 1000) to mapped folder)

⁠Network

Network binding should be to the host (not bridged)

correctly, but fixed IP address is advised. Also different VLANs between UC remote and Harmony Hub should work (integration should be connected to both VLANs).

⁠Environment variables

The following enviroment variables can be used.

⁠Volume mapping:

Map a volume to /app/config for the settingsfile config.json (in volume mapped folder). If no volume is mapped a local map in the docker will be used for the settingsfile (which will be lost when docker image is updated).

⁠Integration setup

Integration will register a mDNS record, which remote 2 will use to find the integration. It is possible to do a manual registration on remote 2. Add two environment variables: REMOTE_IP with IP address of the remote and REMOTE_PIN with PIN of the remote. When not using the manual registration methode the integration will ask for PIN (once) to genereate an API key. This API key is used for interaction with remote 2. The setup contains the following steps:

1. select/add one or more Harmony Hubs
2. select profiles to add a Harmony page
3. name of the harmony page (for each hub a new page will be created)
4. select all entities (one Harmony hub mediaplayer and all devices)

After selecting entities, integration will create the interface. This will will take 1 minute for each Hub after device selection. Remote 2 will restart after setup is complete. Restart is necessary to fix a UI issue (not showing icons) after setup.

The integration can handle multiple Hubs and can be used with multiple remote 2. For short: one integration for multiple remotes and multiple devices!

⁠Changes

⁠v0.2.9

• bug fixes

⁠v0.2.8

The first time after starting v0.2.8 the integration will try to update configuration and UI. If this fails, the advice is to follow the next procedure: delete integration, on the UC remote manually delete all Harmony group/activities, stop docker container, delete the file config.json (in mapped folder), start the docker container and add/setup the integration to the UC remote.

new

• reconfiguration extra options: rebuild UI pages, reset setup, sync with Harmony hub

fixes

• connection to Harmony Hub more robust
• reconfiguration fixed
• multi hub UI pages build
• don't loose active activities through restart of UI
• activity updating (sync between different remotes)
• remote, integration & hub can be on different networks
• several bugs

⁠v0.2.7

• added iputils-ping package in container

⁠v0.2.6

• initial version published