Git Product home page Git Product logo

ha-firemote's Introduction

HA-Firemote

hacs_badge GitHub release (latest by date) Maintenance

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

Fire TV Fire TV Cube,
Fire TV Stick 4K Max
Fire TV Stick 4K Fire TV Stick Lite Fire Stick (1st Gen)
Fire TV 4 Series Remote Fire TV Cube (Gen 2) Remote Fire TV Stick 4K Fire TV Stick Lite Fire Stick (1st Gen)



Prerequisites

  • A functioning version of Home Assistant
  • HACS
  • 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

  1. Turn on ADB Debugging on your Amazon device
  2. Set up the Home Assistant Android TV Integration and connect it to your Amazon Fire Device
  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


How to use

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

Dashboard


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_4_series
fire_tv_cube_second_gen
fire_tv_stick_4k_max
fire_stick_4k
fire_tv_stick_lite
fire_stick_first_gen
The type of device you are controlling
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
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
disney-plus
hbo-max
hulu
jellyfin
netflix
pandora
paramount-plus
plex
prime-video
showtime
starz
tennis-channel
twitch
youtube
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
scale integer no Any positive number Change the size of this card by percentage. Default size is 100
button_overrides complex no read details in README.md file read details in 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, and it suddenly stopped without making any configuration changes, it could be that all you need to do is press one button (any button) on your physical Fire TV device. 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.

ha-firemote's People

Contributors

prprod avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.