/firetv-card

Primary LanguageTypeScriptMIT LicenseMIT

📺 Roku Remote Card

GitHub Release License hacs_badge

Project Maintenance GitHub Activity

Discord Community Forum

Twitter Github

Support

Hey dude! Help me out for a couple of 🍻 or a ☕!

coffee

This card is for Lovelace on Home Assistant that display a FireTV remote.

example

Installation

Use HACS or follow this guide

resources:
    url: /local/firetv-card.js
    type: module

Options

Name Type Requirement Description
type string Required custom:firetv-card
entity string Required media_player entity of FireTV device
name string Optional Card name
theme string Optional Card theme
tv boolean Optional If true shows volume and power buttons. Default false
power map Optional Button configuration for power See button options
volume_up map Optional Button configuration for volume_up See button options
volume_down map Optional Button configuration for volume_down See button options
volume_mute map Optional Button configuration for volume_mute See button options
up map Optional Button configuration for up See button options
down map Optional Button configuration for down See button options
left map Optional Button configuration for left See button options
right map Optional Button configuration for right See button options
home map Optional Button configuration for home See button options
menu map Optional Button configuration for menu See button options
back map Optional Button configuration for back See button options
center map Optional Button configuration for center See button options
rewind map Optional Button configuration for rewind See button options
fast_forward map Optional Button configuration for fast_forward See button options
apps map Optional List of app shortcuts See app options

app Options

Name Type Requirement Description
app string Optional Name of the source to launch as tap_action
image string Optional Path to image to use for app
tap_action map Optional Tap action map See action options
hold_action map Optional Hold action map See action options
double_tap_action map Optional Doulbe Tap action map See action options

button Options

Name Type Requirement Description
show boolean Optional Show/Hide button true
tap_action map Optional Tap action map See action options
hold_action map Optional Hold action map See action options
double_tap_action map Optional Doulbe Tap action map See action options

action Options

Name Type Default Supported options Description
action string toggle more-info, toggle, call-service, none, navigate, url Action to perform
entity string none Any entity id Only valid for action: more-info to override the entity on which you want to call more-info
navigation_path string none Eg: /lovelace/0/ Path to navigate to (e.g. /lovelace/0/) when action defined as navigate
url_path string none Eg: https://www.google.com URL to open on click when action is url.
service string none Any service Service to call (e.g. media_player.media_play_pause) when action defined as call-service
service_data map none Any service data Service data to include (e.g. entity_id: media_player.bedroom) when action defined as call-service.
haptic string none success, warning, failure, light, medium, heavy, selection Haptic feedback for the Beta IOS App
repeat number none eg: 500 How often to repeat the hold_action in milliseconds.

Usage

type: "custom:firetv-card"
entity: media_player.basement_firetv
tv: true
apps:
  - image: /local/netflix.webp
    app: Netflix
  - image: /local/hulu.webp
    app: Hulu
    hold_action:
      action: call-service
      service: media_player.select_source
      service_data:
        source: ESPN
volume_up:
  tap_action:
    action: call-service
    service: remote.send_command
    service_data:
      entity_id: remote.basement_roku
      command: play
volume_down:
  double_tap_action:
    action: call-service
    service: remote.send_command
    service_data:
      entity_id: remote.basement_roku
      command: play

Troubleshooting

Developers

Fork and then clone the repo to your local machine. From the cloned directory run

npm install && npm run build