Add-on:Harmony Hub Controller

From Official Kodi Wiki
Jump to navigation Jump to search

Harmony Hub Controller

See this add-on on the showcase

Author: pkscout
Website: link
Type: Program
Repo: repo v21 repo v20 repo v19

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.


This add-on is installed from the Add-on browser located in Kodi as follows:

  1. Settings
  2. Add-ons
  3. Install from repository
  4. Program Add-ons
  5. Harmony Hub Controller
  6. Install


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

How to use this addon


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.


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:


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.



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 ||||.

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:


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