Harmony Card by @sbryfcz

Added activity icons & hide activities options by @mattieha

Added hold & double tap actions for buttons by @mattieha

A custom Home Assistant card to integrate with Harmony Hubs.

Support

Hey there! Hope you are enjoying my work. Help me out for a couple of 🍻 or a ☕!

Options

Name	Type	Requirement	Description	Default
type	string	Required	`custom:harmony-card`
name	string	Optional	Card name
entity	string	Required	Home Assistant entity ID of Harmony
volume_entity	string	Optional	Home Assistant entity ID of volume control media_player
volume_device	string	Optional	Harmony device name to control volume
hide_keyPad	boolean	Optional	Hides the KeyPad	`true`
activites	Activity	Required	List of Activities (see below)
show_activities_icons	boolean	Optional	Show activity buttons as icons	`false`
hide_activities	boolean	Optional	Hide activities	`false`
scale	number	Optional	A multiplier to scale the icons by	1
buttons	Button Dictionary	Optional	A dictionary/object of button config to override defaults

Activity Options

Name	Type	Requirement	Description	Default
name	string	Required	The name of the harmony activity as named in the harmony config
device	string	Required	The name of the harmony device as named in the harmony config to use for sending commands
icon	string	Optional	The icon to display for the button (ex. `mdi:` + http://materialdesignicons.com/)
volume_entity	string	Optional	Home Assistant entity ID of volume control media_player
volume_device	string	Optional	Harmony device name to control volume
hide_keyPad	boolean	Optional	Hides the KeyPad	`true`
buttons	Button Dictionary	Optional	A dictionary/object of button config to override defaults

Button Options

These options let you override the default icon, commands, devices, and visibility.

Name	Type	Requirement	Description	Default
command	string	Optional	The device command to use	See below
device	string	Optional	The harmony device name to send the command to	See below
icon	string	Optional	The icon to display for the button (ex. `mdi:` + http://materialdesignicons.com/)	See below
hide	string	Optional	Should this button be hidden	false
color	string	Optional	A css string to represent the color ex. '#ff0000'
hold_action	object	Optional	Action to take on hold	`none`
double_tap_action	object	Optional	Action to take on hold	`none`

Action Options

Name	Type	Requirement	Description	Default
action	string	Required	Action to perform (more-info, toggle, call-service, navigate url, none)	`more-info`
navigation_path	string	Optional	Path to navigate to (e.g. /lovelace/0/) when action defined as navigate	`none`
url_path	string	Optional	URL to open on click when action is url. The URL will open in a new tab	`none`
service	string	Optional	Service to call (e.g. media_player.media_play_pause) when action defined as call-service	`none`
service_data	object	Optional	Service data to include (e.g. entity_id: media_player.bedroom) when action defined as call-service	`none`
haptic	string	Optional	Haptic feedback for the Beta IOS App success, warning, failure, light, medium, heavy, selection	`none`
repeat	number	Optional	How often to repeat the `hold_action` in milliseconds.	`non`

Buttons Available to Configure with Defaults:

0:
    command: '0',
    icon: 'mdi:numeric-0-circle',
    hide: false
1:
    command: '1',
    icon: 'mdi:numeric-1-circle',
    hide: false
2:
    command: '2',
    icon: 'mdi:numeric-2-circle',
    hide: false
3:
    command: '3',
    icon: 'mdi:numeric-3-circle',
    hide: false
4:
    command: '4',
    icon: 'mdi:numeric-4-circle',
    hide: false
5:
    command: '5',
    icon: 'mdi:numeric-5-circle',
    hide: false
6:
    command: '6',
    icon: 'mdi:numeric-6-circle',
    hide: false
7:
    command: '7',
    icon: 'mdi:numeric-7-circle',
    hide: false
8:
    command: '8',
    icon: 'mdi:numeric-8-circle',
    hide: false
9:
    command: '9',
    icon: 'mdi:numeric-9-circle',
    hide: false
volume_down:
    command: 'VolumeDown',
    icon: 'mdi:volume-medium',
    hide: false
volume_up:
    command: 'VolumeUp',
    icon: 'mdi:volume-high',
    hide: false
volume_mute:
    command: 'Mute',
    icon: 'mdi:volume-off',
    hide: false
skip_back:
    command: 'SkipBack',
    icon: 'mdi:skip-previous',
    hide: false
play:
    command: 'Play',
    icon: 'mdi:play',
    hide: false
pause:
    command: 'Pause',
    icon: 'mdi:pause',
    hide: false
skip_forward:
    command: 'SkipForward',
    icon: 'mdi:skip-next',
    hide: false
dpad_up:
    command: 'DirectionUp',
    icon: 'mdi:chevron-up-circle',
    hide: false
dpad_down: 
    command: 'DirectionDown',
    icon: 'mdi:chevron-down-circle',
    hide: false
dpad_left:
    command: 'DirectionLeft',
    icon: 'mdi:chevron-left-circle',
    hide: false
dpad_right:
    command: 'DirectionRight',
    icon: 'mdi:chevron-right-circle',
    hide: false
dpad_center: 
    command: 'OK',
    icon: 'mdi:checkbox-blank-circle',
    hide: false
xbox:
    command: 'Xbox',
    icon: 'mdi:xbox',
    hide: false
back:
    command: 'Back',
    icon: 'mdi:undo-variant',
    hide: false
a:
    command: 'A',
    icon: 'mdi:alpha-a-circle',
    hide: false
    color: '#2d9f1c'
b:
    command: 'B',
    icon: 'mdi:alpha-b-circle',
    hide: false
    color: '#e43308'
x:
    command: 'X',
    icon: 'mdi:alpha-x-circle',
    hide: false
    color: '#003bbd'
y:
    command: 'Y',
    icon: 'mdi:alpha-y-circle',
    hide: false
    color: '#f1c70f'

Configuration Order of Precedence

In general the configuration for the card will be determined from more specific configuration to less specific configuration. By this, I mean that if there is both global card configuration and activity configuration, this plugin will use the activity level configuration.

Simple example:

- type: 'custom:harmony-card'
  entity: remote.living_room_hub
  volume_entity: media_player.living_room
  activities:
  - name: Play Xbox One
    device: Microsoft Xbox One
    volume_entity: media_player.alexa
  - name: Listen to Music
    device: Onkyo AV Receiver

In this case, the card will issue commands via media_player.alexa if the current activity is 'Play Xbox One'. Otherwise, it will use media_player.living_room.

Volume

Furthermore, volume controls try to use specified media players (if configured) since those offer most robust functionality (ie. the volume slider). So the order of precedence for volume controls are:

Activity Level volume_entity
Activity Level volume_device
Card Level volume_entity
Card Level volume_device

Devices

Devices to be used for buttons follow the following order of precedence:

Activity-button level device
Card-button level device
Activity level device
Card level device

Example Configuration

Resources

resources:
- type: module
  url: '/community_plugin/harmony-card/harmony-card.js'

Card

- type: 'custom:harmony-card'
  entity: remote.living_room_hub
  volume_entity: media_player.living_room
  scale: 1.25
  activities:
  - name: Play Xbox One
    device: Microsoft Xbox One
  - name: Listen to Music
    device: Onkyo AV Receiver

Card with Custom Button Config

- type: 'custom:harmony-card'
  entity: remote.living_room_hub
  volume_entity: media_player.living_room
  scale: 1.25
  activities:
  - name: Play Xbox One
    device: Microsoft Xbox One
  - name: Listen to Music
    device: Onkyo AV Receiver
  buttons:
    a:
      icon: 'mdi:chevron-up'
      device: Onkyo AV Receiver
      command: VolumeUp
    b:
      icon: 'mdi:chevron-down'
      device: Onkyo AV Receiver
      command: VolumeDown

Advanced example with hold actions, custom delays, custom icons and customized activity buttons

- type: 'custom:harmony-card'
  entity: remote.harmony
  show_activities_icons: true
  scale: 1.5
  volume_device: tv
  activities:
    - name: Smart TV
      icon: mdi:youtube-tv
      device: tv
      buttons:
        '0':
          hide: false
        '1':
          hide: false
        '2':
          hide: false
        '3':
          hide: false
        '4':
          hide: false
        '5':
          hide: false
        '6':
          hide: false
        '7':
          hide: false
        '8':
          hide: false
        '9':
          hide: false
        xbox:
          hide: false
          icon: mdi:home-circle
          command: home
        back:
          command: back
          hide: false
        a:
          command: ActionMenu
          hide: false
          icon: 'mdi:microsoft-xbox-controller-menu'
          color: '#E0E1E1'
        b:
          hide: false
          command: netflix
          icon: 'mdi:netflix'
          color: '#E0E1E1'
        x:
          hide: false
          command: Yellow
          icon: 'mdi:circle'
          color: '#f1c70f'
        'y':
          hide: false
          command: Blue
          icon: 'mdi:circle'
          color: '#003bbd'
        dpad_center:
          hide: false
          command: select
          hold_action:
            action: call-service
            service: remote.send_command
            service_data:
              entity_id: remote.harmony
              device: tv
              hold_secs: 2.5
              command: select
        dpad_down:
          hide: false
        dpad_left:
          hide: false
        dpad_right:
          hide: false
        dpad_up:
          hide: false
        pause:
          hide: false
          icon: mdi:play-pause
        play:
          hide: false
          icon: mdi:stop
          command: stop
        skip_back:
          hide: false
        skip_forward:
          hide: false
        volume_down:
          hide: false
        volume_mute:
          hide: false
        volume_up:
          hide: false
    - name: Listen to Music
      device: LG Amp
      icon: mdi:music
      volume_entity: media_player.living_room_bar
    - name: Play a Game
      device: speelcomputer Microsoft
      icon: mdi:microsoft-xbox-controller
    - name: Watch TV
      device: DVR KPN
      icon: mdi:television-classic
      buttons:
        '0':
          hide: false
        '1':
          hide: false
        '2':
          hide: false
        '3':
          hide: false
        '4':
          hide: false
        '5':
          hide: false
        '6':
          hide: false
        '7':
          hide: false
        '8':
          hide: false
        '9':
          hide: false
        xbox:
          hide: true
        back:
          command: Cancel
          hide: false
        a:
          command: Red
          hide: false
          icon: 'mdi:circle'
          color: '#e43308'
        b:
          hide: false
          command: Green
          icon: 'mdi:circle'
          color: '#2d9f1c'
        x:
          hide: false
          command: Yellow
          icon: 'mdi:circle'
          color: '#f1c70f'
        'y':
          hide: false
          command: Blue
          icon: 'mdi:circle'
          color: '#003bbd'
        dpad_center:
          hide: false
          command: select
        dpad_down:
          hide: false
        dpad_left:
          hide: false
        dpad_right:
          hide: false
        dpad_up:
          hide: false
        pause:
          hide: false
        play:
          hide: false
        skip_back:
          hide: false
        skip_forward:
          hide: false
        volume_down:
          hide: false
        volume_mute:
          hide: false
        volume_up:
          hide: false
  show_warning: false
  hide_keyPad: false
  show_error: false
  buttons:
    '0':
      hide: true
    '1':
      hide: true
    '2':
      hide: true
    '3':
      hide: true
    '4':
      hide: true
    '5':
      hide: true
    '6':
      hide: true
    '7':
      hide: true
    '8':
      hide: true
    '9':
      hide: true
    a:
      hide: true
    b:
      hide: true
    back:
      hide: true
    dpad_center:
      hide: true
    dpad_down:
      hide: true
    dpad_left:
      hide: true
    dpad_right:
      hide: true
    dpad_up:
      hide: true
    pause:
      hide: true
    play:
      hide: true
    skip_back:
      hide: true
    skip_forward:
      hide: true
    volume_down:
      hide: true
    volume_mute:
      hide: true
    volume_up:
      hide: true
    x:
      hide: true
    xbox:
      hide: true
    'y':
      hide: true

Development

Step 1

Clone this repository

Step 2

Install necessary modules (verified to work in node 8.x) yarn install or npm install

Step 3

Do a test lint & build on the project. You can see available scripts in the package.json npm run build

Step 4

Run in a server using npm run start. This will host the resource locally. Add the resource to your resources in your configuration. Example:

resources:
- type: module
  url: 'http://0.0.0.0:5000/harmony-card.js'

Name		Name	Last commit message	Last commit date
Latest commit History 67 Commits
.vscode		.vscode
dist		dist
img		img
src		src
.eslintrc.js		.eslintrc.js
.gitignore		.gitignore
.prettierrc.js		.prettierrc.js
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
hacs.json		hacs.json
package-lock.json		package-lock.json
package.json		package.json
rollup.config.js		rollup.config.js
tsconfig.json		tsconfig.json
yarn.lock		yarn.lock

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Harmony Card by @sbryfcz

Support

Options

Activity Options

Button Options

Action Options

Configuration Order of Precedence

Volume

Devices

Example Configuration

Resources

Card

Card with Custom Button Config

Advanced example with hold actions, custom delays, custom icons and customized activity buttons

Development

Step 1

Step 2

Step 3

Step 4

About

Releases

Packages

Languages

License

1ntroduc3/harmony-card

Folders and files

Latest commit

History

Repository files navigation

Harmony Card by @sbryfcz

Support

Options

Activity Options

Button Options

Action Options

Configuration Order of Precedence

Volume

Devices

Example Configuration

Resources

Card

Card with Custom Button Config

Advanced example with hold actions, custom delays, custom icons and customized activity buttons

Development

Step 1

Step 2

Step 3

Step 4

About

Resources

License

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages