Need More Information? Check out this project's Wiki page

• A functioning version of Home Assistant
• HACS (not required, but it makes things easier)
• A supported device
  • Amazon Fire Smart TV
  • Amazon Fire Stick
  • Amazon Fire Cube
  • Apple TV
  • NVIDIA Shield
  • NVIDIA Shield Pro
  • Xiaomi Mi Box S
  • Chromecast
  • Other Android-based non-fire devices might work as well, but with limited (and unsupported) functionality

Which Amazon Fire devices are supported?
Which Amazon Fire device do I own?
Which Apple TV device do I own?
Which NVIDIA Shield devices are supported?
Which NVIDIA Shield device do I own?
Which Xiaomi Mi device do I own?
Which Chromecast device do I own?

1. For non-Apple TV users, Turn on ADB Debugging on your Amazon, Shield, Xiaomi, Chromecast, or Android TV device
2. Connect your device to Home Assistant:
   • Amazon, Shield, Xiaomi, Chromecast, or Android TV users:
     • Set up the Home Assistant Android Debug Bridge Integration and connect it to your device (always required in every setup)
     • Optionally, for non Amazon Fire devices only, you may additionally choose to set up the Home Assistant Android TV Remote Integration and connect it to your device. (optional)
   • Apple TV Users
     • Set up the Home Assistant Apple TV Integration and connect it to your device. This will create a "Media Player" entity, and a "Remote" entity automatically.
3. Click on HACS and select Frontend
4. In the lower right-hand corner, click the "+ EXPLORE & DOWNLOAD REPOSITORIES" button
5. Search for, and click on "Firemote Card" then click the "DOWNLOAD" button in the lower right-hand corner
6. You will be prompted to reload your browser. Click the RELOAD button to continue

1. For non-Apple TV users, Turn on ADB Debugging on your Amazon, Shield, Xiaomi, Chromecast, or Android TV device
2. Connect your device to Home Assistant:
   • Amazon, Shield, Xiaomi, Chromecast, or Android TV users:
     • Set up the Home Assistant Android Debug Bridge Integration and connect it to your device (always required in every setup)
     • Optionally, for non Amazon Fire devices only, you may additionally choose to set up the Home Assistant Android TV Remote Integration and connect it to your device. (optional)
   • Apple TV Users
     • Set up the Home Assistant Apple TV Integration and connect it to your device. This will create a "Media Player" entity, and a "Remote" entity automatically.
3. Download the contents of the dist/ directory, and place it in your Home Assistant /config/www directory
4. Register the HA-Firemote.js file that you just installed as a new resource

1. On any dashboard, click the +ADD CARD button
2. Search by cards for "Firemote Card" and click on it
3. Under the Device Family dropdown, choose "Amazon Fire", "Apple TV", "Chromecast", "NVIDIA Shield", or "Xiaomi"
   • Amazon, Shield, Xiaomi, Chromecast, or Android TV users:
     • Under Device Model, select the device model that you own. (Help: Which Amazon Fire or NVIDIA Shield device do I own?)
     • Under the Android Debug Bridge Entity dropdown, a list of your Android Debug Bridge integration entities will appear. Select the one you wish to control.
     • If you are setting up something other than an Amazon Fire device, select the Associated Android TV Remote Entity that points to the same device as your Android Debug Bridge entity. This step is not required, but it will greatly improve the speed and reliability of your Firemote card
   • Apple TV Users
     • Under Apple TV Device Model, select the device model that you own
     • Under Apple TV Media Player Entity, select the Apple TV Media Player entity you wish to control
     • Under Apple TV Remote Entity, select the Apple TV remote entity that is associated with the Apple TV Media Player Entity you chose in the previous step
4. Make any other optional changes to your card, then click "SAVE" Other options include changing the app launch buttons to apps that you use most often, or changing the style of your remote control to look like something completely different from what shipped with your device. You can even add names and adjust the size of your Firemote card too!

Click here to see the full gallery

Examples:

type: custom:firemote-card
entity: media_player.fire_tv_192_168_1_30
device_family: amazon-fire
device_type: fire_tv_4_series
compatibility_mode: default
app_launch_1: prime-video
app_launch_2: netflix
app_launch_3: hdmi_1
app_launch_4: youtube
hdmi_1: Cable
scale: 85

type: custom:firemote-card
entity: media_player.apple_tv_4k_2nd_gen
device_family: apple-tv
device_type: appletv-4k-gen2
compatibility_mode: default
apple_tv_remote_entity: remote.apple_tv_4k_2nd_gen
app_launch_1: apple-appstore
app_launch_2: apple-tv-arcade
app_launch_3: mlb
app_launch_4: nfl
visible_name_text: Game Room
name_position: top
button_overrides:
  mute-button:
    script: receiver_mute_script

type: custom:firemote-card
entity: media_player.android_tv_192_168_107_209
device_family: nvidia-shield
device_type: shield-tv-pro-2019
compatibility_mode: default
android_tv_remote_entity: remote.shield
scale: '100'
app_launch_1: netflix
app_launch_2: function-find-my-remote
app_launch_3: function-mute

Options:

Custom app launch buttons are not limited to the few that came printed on your remote control. In fact, the possibilities are endless! If you don't see your favorite app on this list, you can click on the Issues button on the top of this page, click 'New Issue' and then click the "Get Started" button next to the "App Shortcut Request" option. Your request is important to you and likely important to others as well! As long as the app is easily downloaded through your device's app store (not sideloaded), your request will be granted ASAP.

Options:

Button Overrides can be very useful for customization. These overrides can be used to call a Home Assistant service directly, run a script, or hide a button on your remote. These options are accomplished through your Firemote's YAML configuration.

Consider this example:

button_overrides:
  mute-button:
    script: receiver_mute_script
  volume-down-button:
    script: receiver_volume_down_script
  volume-up-button:
    service: light.toggle
    target:
      entity_id: light.bedroom_lamp
    data:
      color_name: red
      transition: 2
      brightness_pct: 100
  power-button:
    hidden: true

Valid button names are as follows:

• app-switch-button
• apps-button
• back-button
• center-button
• channel-down-button
• channel-up-button
• down-button
• fastforward-button
• hamburger-button
• headset-button
• home-button
• input-button
• keyboard-button
• left-button
• mute-button
• playpause-button
• power-button
• programmable-one-button
• programmable-two-button
• restart-button
• rewind-button
• right-button
• search-button
• settings-button
• tv-button
• up-button
• volume-down-button
• volume-up-button

In many cases, your remote control sends commands for volume, mute, and power to your TV or receiver using the IR emitter on the front of the physical remote control. These IR commands cannot be sent in a traditional Home Assistant setup.

If your player device AND the device they are connected to both offer CEC options, then activating CEC will allow the Firemote card controls to work as expected. Click here to learn more about how to configure CEC to work with your Firemote. Another option might be to control your devices (TVs, Receivers, etc.) using Button Overrides. If you can control those kinds of devices through Home Assistant, you can write a HA script and attach that script to a button on your Firemote.

Due to the way the Apple TV Home Assistant integration is built, an Apple TV style Firemote cannot properly simulate a "Mute" button press. A Button Override will be required in this case.

• If your Firemote used to work perfectly, and some or all of the buttons suddenly stopped working, it could be that all you need to do is press one button (any button) on your Fire TV device's physical remote control. After doing that step, try your Firemote again. This step most commonly fixes the issue in Amazon Fire devices after they are powered on, restarted, or updated.
• Check your card configuration:
  • Is the correct Android device selected?
  • Is the correct Device Family selected?
  • Is the correct Device type selected?
  • If you are using it, is the correct matching Android TV Remote Entity selected?
  • Is Compatibility Mode set to Default?
• If the Default Compatibility Mode is not working on your device, and you've checked every other step, slowly choose "event0", "event1", etc. and test your remote buttons under each mode. One of these will work.

There are over 40 kinds of Amazon Fire devices, so it will take a while to gain properly tested support for all of them. If Firemote doesn't support your Amazon Fire device yet, you can still use Firemote! Simply choose a supported device that is similar to the one that you have (preferably a remote that looks the same as your physical remote), then you can test different compatibility modes to find out which one works the best.

For extra credit, you could submit a request to have your device added! It's simple! Click on the Issues button on the top of this page, click 'New Issue' and then click the "Get Started" button next to the "Device Support Request" option. Your help is VERY appreciated!

Apple TV app shortcuts work simply by passing the name of the app to the apple tv remote entity. Firemote is built and tested against an environment that uses English as the primary language. In some scenarios, built-in Apple TV apps use language app specific names, which is why asking it to open the English version of that app's name does not work. In order to overcome this, I request that you click the Issues button at the top of this page so we can work together and make all of these buttons work in your native language.

Absolutely! Simply ask! Here's how: Click the Issues button at the top of this page, click 'New Issue' and then click the "Get Started" button next to the "App Shortcut Request" option. Your request is important to you and likely important to others as well! If the app is easily downloaded through your device's official store (not sideloaded), your request will be granted ASAP.

Click on the Issues button at the top of this page, click 'New Issue', and select the appropriate category for your needs. You're also welcome to join or begin a new discussion if that suits your needs.

• Take a look at the current discussions board to see if anything is tagged with "Help Wanted".
• 
• Since it is personally expensive for me to purchase, evaluate, and develop integrations for all of your requests, I've set up an Amazon Wish List (US) and an Amazon Wish List (DE) for any of you who are feeling incredibly generous and want to send me something that I don't already own.