Add-on:Harmony Hub Controller

From Official Kodi Wiki
Revision as of 04:12, 18 July 2021 by Addonbot (talk | contribs) (Addon-Bot repo category update)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Harmony Hub Controller

See this add-on on the kodi.tv showcase

Author: pkscout
Website: link
Type: Program
Repo: Kodi.tv repo v20
Kodi.tv repo v19
Kodi.tv repo v18

License: GPL-2.0-only
Source: Source code
Summary: Addon to send activity and remote commands via a Harmony Hub.
Home icon grey.png   ▶ Add-ons ▶ Harmony Hub Controller
Attention talk.png Need help with this add-on? See here.

Harmony Hub Controller let's you setup actions to run a Harmony activity and/or a sequence of remote commands. Running the addon gives you a menu of your actions, and you can also send an action name as an arg to have the script run a specific action.

1 Installing

To install this add-on you must do so from the Add-on manager from within Kodi by going to

  1. The home screen
  2. Add-ons
  3. Download
  4. Program Add-ons
  5. Harmony Hub Controller
  6. Install

2 Features

  • Allows you to send commands to a Harmony Hub (either just activities or, with advanced settings, individual remote commands)

3 How to use this addon

3.1 Basic

Once installed, you need to go to the add-on settings, input the IP address, and then use the Edit mappings option in the settings to create a mapping of Harmony Hub Controller menu item to a Harmony Hub Activity. When you type in the name of activity, use the exact name you gave it on the Harmony Hub. Save the settings, then run the Add-on. A menu will appear with the mapping(s) you made. Select one, and the script will run that Activity on the Hub.

3.2 Advanced

There is an option in the settings for advanced control of the Harmony Hub. If you enable that, you can send remote commands (either just one or a string of them) in addition to the activity. When enabled, there is an additional screen in the Edit mappings process to add additional commands. The general syntax for commands is:

<command>|<command>|command

Where command is one of the remote button commands, and the pipe (|) is a pause. You can add a longer pause by adding pipes with no command between them. The one trick here is that you have to know the exact name of the command the Hub uses. To help a little, the script logs all the commands the Hub knows to the Kodi logfile when debug logging is on. So to get a list of all commands the hub knows, enable Kodi debug logging, then also enable debug logging in the Harmony Hub Controller Add-on, and then run one of the activities you already defined. Then go to the kodi.log file and look for some lines that look like this:

2021-03-12 11:49:47.649 T:1906540   DEBUG <general>: [Harmony Hub Control] the complete list of commands by device is:

Right below that will be a line that is the dump of all the commands. My apologies that it's a bit hard to read, but it should get you what you need.

4 Settings

4.1 General

Harmony Hub IP Address
The IP address of your Harmony Hub.

Delay Between Remote Commands:
The amount of delay added between commands when you add a pipe character (|). Adding pipes back to back increase the delay. So, for instance, to get a 1 second delay, you would use ||||.

Timeout
The amount of time before the script gives up trying to contact the Hub.

Enable Advanced Harmony Hub Control
Enabling this setting let's you send individual commands to the Hub rather than just activities. See the Advanced Usage section for more information on this.

Use Custom Select Menu
This script can use either a standard dialog box or one customized to match the skin you are using. If you're skin isn't supported, you will get a kind of generic "custom" menu. Setting the additional option for supporting skin mods as well means that if you use a skin mod like skin.estuary.mod, then the script will use the skin.estuary menu. The script currently supports custom menus for the following skins:

skin.ace2
 skin.aeon.nox.silvo
 skin.aeon.tajo
 skin.aeonmq8
 skin.amber
 skin.apptv
 skin.arctic.horizon
 skin.arctic.zephyr.2
 skin.aura
 skin.bello.7
 skin.box
 skin.confluence
 skin.embuary-leia
 skin.eminence.2
 skin.estuary
 skin.ftv
 skin.pellucid
 skin.quartz
 skin.rapier
 skin.revolve
 skin.transparency
 skin.unity
 skin.xperience1080

Enable Debug Logging
If Kodi debug logging is enabled, this setting will log additional details to the Kodi log file for debug purposes.