HA-Firemote

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

Prerequisites

A functioning version of Home Assistant
HACS (not required, but it makes things easier)
A supported Amazon Fire Device Type
- Amazon Fire Smart TV
- Amazon Fire Stick
- Amazon Fire Cube
- Other Android based non-fire devices might work as well, but with limited (and unsupported) functionality

Which devices are supported?
Which device do I own?

Download and Setup via Home Assistant UI & HACS

Turn on ADB Debugging on your Amazon device
Set up the Home Assistant Android TV Integration and connect it to your Amazon Fire Device
Click on HACS and select Frontend
In the lower right hand corner, click the "+ EXPLORE & DOWNLOAD REPOSITORIES" button
Search for, and click on "Firemote Card", then click the "DOWNLOAD" button in the lower right hand corner
You will be prompted to reload your browser. Click the RELOAD button to continue

OR Install Manually

Turn on ADB Debugging on your Amazon device
Set up the Home Assistant Android TV Integration and connect it to your Amazon Fire Device
Download a copy of HA-Firemote.js and place it in your Home Assistant /config/www directory
Register this file as a new resource

How to use

On any dashboard, click the +ADD CARD button
Search by cards for "Firemote Card", and click on it
Under the Entity dropdown, a list of your Android TV integration entities will appear. Select the one you wish to control.
Under Fire Device Type, select the proper device type
Click "SAVE"

YAML card setup options

Example:

type: custom:firemote-card
entity: media_player.fire_tv_192_168_1_30
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
button_overrides:
  mute-button:
    script: receiver_mute_script

Options:

Name	Type	Required	Options	Description
type	string	yes	custom:firemote-card	Type of the card
entity	string	yes	any valid entity created in the android tv integration	entity_id
device_type	string	yes	fire_tv_toshiba_v35 fire_tv_4_series fire_tv_cube_third_gen fire_tv_cube_second_gen fire_tv_stick_4k_max fire_tv_3rd_gen fire_tv_stick_lite fire_stick_4k fire_stick_first_gen	The type of device you are controlling Which devices are supported? Which device do I own?
compatibility_mode	string	no	default strong event0 event1 event2 event3 event4 event5 event6 event7 event8	Adjust this value only if your buttons are completely unresponsive FAQ Available for additional help
app_launch_1 app_launch_2 app_launch_3 app_launch_4 app_launch_5 app_launch_6	string	no	amc-plus apple-tv bbc-iplayer bell-fibe-tv crave-tv cyberghost disney-plus emby hbo-max hulu jellyfin netflix pandora paramount-plus plex prime-video shophq showtime starz tennis-channel twitch youtube vlc zattoo hdmi_1 hdmi_2 hdmi_3 hdmi_4	Quick launch apps customization
hdmi_1 hdmi_2 hdmi_3 hdmi_4	string	no	Personalized name for this HDMI input	The name entered here will appear on the button (truncated to 8 characters to fit)
scale	integer	no	Any positive number	Change the size of this card by percentage. Default size is 100
button_overrides	object	no	Button name and HA script name are required.	Details are in the Button Overrides section of the README.md file

Button Overrides

Firemote buttons can be overridden by Home Assistant scripts through a simple YAML configuration.

Ex:

button_overrides:
  mute-button:
    script: receiver_mute_script
  volume-down-button:
    script: receiver_volume_down_script

Valid button names are as follows:

power-button
keyboard-button
up-button
left-button
center-button
right-button
down-button
back-button
home-button
hamburger-button
rewind-button
playpause-button
fastforward-button
volume-up-button
channel-up-button
volume-down-button
tv-button
channel-down-button
mute-button
settings-button
app-switch-button

FAQ

Why won't my volume, mute, and/or power butons work?

In many cases, your Amazon remote control actually sends commands for volume, mute, and power to your TV or receiver using the IR emitter on the front of the physical remote control. Since this is the case, these types of commands cannot be emulated through the same means that Firemote sends other commands.

In these cases, you still might be able to control your devices (TVs, Receivers, etc.) by using Button Overrides. If you are able to control your non-fire devices through Home Assistant, you can write a HA script and attach that script to a button on your Firemote.

Why don't any of the buttons on the Firemote work at all?

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.
Check your card configuration:
- Is the correct Android device selected?
- Is the correct Fire TV Device type 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.

Why isn't my Fire Device supported?

There are currently over 40 different kinds of Amazon Fire devices, so it will take a while for every device to gain properly tested support. If Firemote doesn't support your device yet yet, you can still use Firemote! Simply choose a supported device that is similar to the one that you have (preferrably a remote that looks the same as your physical remote), then you can test different compatability 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!

I want to have a shortcut button for an app I use frequently, but it's not on the list. Can it be added?

Absolutely! Simply ask! Here's how: 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 for others as well! As long as the app is easily downloaded through traditional Amazon app downloading channels (not sideloaded), your request will be granted ASAP.

How do I report a problem, make a request, or just talk about stuff?

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

klugev303/HA-Firemote