{"id":13622607,"url":"https://github.com/PRProd/HA-Firemote","last_synced_at":"2025-04-15T09:33:12.729Z","repository":{"id":60681192,"uuid":"536329656","full_name":"PRProd/HA-Firemote","owner":"PRProd","description":"Apple TV, Amazon Fire TV, Fire streaming stick, Chromecast, NVIDIA Shield, onn., Roku, Xiaomi Mi, and Android TV remote control card for Home Assistant","archived":false,"fork":false,"pushed_at":"2024-05-21T18:25:52.000Z","size":5003,"stargazers_count":345,"open_issues_count":10,"forks_count":64,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-05-22T17:50:26.960Z","etag":null,"topics":["amazon-fire","amazon-fire-cube","amazon-fire-stick","android","android-debug-bridge","android-tv","apple-tv","chromecast","chromecast-4k","home-assistant","home-automation","nvidia","nvidia-shield","onn","remote-control","roku","roku-tv","shield","xiaomi","xiaomi-mi"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PRProd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-09-13T22:31:17.000Z","updated_at":"2024-05-30T00:41:37.218Z","dependencies_parsed_at":"2023-12-08T17:24:36.998Z","dependency_job_id":"c2844c07-6931-407b-8b0c-afa4cfd20cb3","html_url":"https://github.com/PRProd/HA-Firemote","commit_stats":null,"previous_names":[],"tags_count":170,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PRProd%2FHA-Firemote","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PRProd%2FHA-Firemote/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PRProd%2FHA-Firemote/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PRProd%2FHA-Firemote/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PRProd","download_url":"https://codeload.github.com/PRProd/HA-Firemote/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223668250,"owners_count":17182897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amazon-fire","amazon-fire-cube","amazon-fire-stick","android","android-debug-bridge","android-tv","apple-tv","chromecast","chromecast-4k","home-assistant","home-automation","nvidia","nvidia-shield","onn","remote-control","roku","roku-tv","shield","xiaomi","xiaomi-mi"],"created_at":"2024-08-01T21:01:21.564Z","updated_at":"2025-04-15T09:33:12.682Z","avatar_url":"https://github.com/PRProd.png","language":null,"funding_links":["https://www.buymeacoffee.com/PRProd"],"categories":["Others","HarmonyOS","Dashboard Cards"],"sub_categories":["Windows Manager","📡 Remote control"],"readme":"# HA-Firemote\n\n\u003e [!NOTE]\n\u003e This Project's Maintainer is currently away\u003cbr\u003e\n\u003e I'm dealing with some health and life issues right now, but I fully intend to be back just as soon as I can\n\u003e  \n\n[![hacs_badge](https://img.shields.io/badge/HACS-Default-41BDF5.svg?style=for-the-badge)](https://github.com/hacs/integration)\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/PRProd/HA-Firemote?style=for-the-badge)\n![Maintenance](https://img.shields.io/maintenance/yes/2025?style=for-the-badge)\n\n\u003ca href=\"https://www.buymeacoffee.com/PRProd\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/default-orange.png\" alt=\"Buy Me A Coffee\" height=\"41\" width=\"174\"\u003e\u003c/a\u003e\n\nNeed More Information?  Check out this project's [Wiki](https://github.com/PRProd/HA-Firemote/wiki) page\n\n| ![JVC 4K Fire TV Remote](https://github.com/PRProd/HA-Firemote/assets/25486599/d4fac2c4-98ea-45c3-a423-fefb72712b15) | ![Fire TV Remote Style 6](https://github.com/PRProd/HA-Firemote/assets/25486599/fdd569fe-f996-4354-bcfb-187443d9c04b) | ![Fire TV Remote Style 5](https://github.com/PRProd/HA-Firemote/assets/25486599/ad71490b-ded1-457e-8737-86424a69c4a9) | ![Fire TV Remote Style 4](https://github.com/PRProd/HA-Firemote/assets/25486599/86d13dae-3292-4099-a2d9-fa9e24439aae) | ![Fire TV Remote Style 3](https://github.com/PRProd/HA-Firemote/assets/25486599/d2ebc221-8230-43d5-9ace-fb5a69973cc5) | ![Fire TV Remote Style 2](https://github.com/PRProd/HA-Firemote/assets/25486599/03953bf3-e295-4692-8b63-be85658037be) | ![Fire TV Remote Style 1](https://github.com/PRProd/HA-Firemote/assets/25486599/4421a30c-f548-44cd-9f00-443529f6ba49) |\n| ------------- | ------------- | ------------- | ------------- | ------------- | ------------- | ------------- |\n\n| ![Apple TV Remote Style 3](https://github.com/PRProd/HA-Firemote/assets/25486599/af60a8e5-5278-4854-8a3d-622e63e44257) | ![Apple TV Remote Style 2](https://github.com/PRProd/HA-Firemote/assets/25486599/f2913052-62da-43f1-b644-f42efad2cf7a) | ![Apple TV Remote Style 1](https://github.com/PRProd/HA-Firemote/assets/25486599/1b0323af-22d6-42c2-9752-ff8e42a08865) | ![NVIDIA Shield Remote 2](https://github.com/PRProd/HA-Firemote/assets/25486599/6138bef5-5714-4c65-a7c6-e35118c696ca) | ![NVIDIA Shield Remote 1](https://github.com/PRProd/HA-Firemote/assets/25486599/f8c65045-f2e3-4bca-b7f3-f4b11bbd59bc) |\n| ------------- | ------------- | ------------- | ------------- | ------------- |\n\n| ![Chromecast Remote](https://github.com/PRProd/HA-Firemote/assets/25486599/36a14224-b46f-4d4c-97ec-b1217e99b272) | ![Xiaomi Mi Remote 2](https://github.com/PRProd/HA-Firemote/assets/25486599/b4c89e40-e80c-4909-9e42-8d77e4e551d2) | ![onn 2](https://github.com/PRProd/HA-Firemote/assets/25486599/eeaf1ffd-0ada-4fa3-b8d3-ae11d6314bff) | ![onn](https://github.com/PRProd/HA-Firemote/assets/25486599/fd2c13a2-d5a6-4173-b324-68bf67c8545d) |\n| ------------- | ------------- | ------------- | ------------- |\n\n| ![Homatics Remote HO1](https://github.com/user-attachments/assets/73b09836-2cf9-4747-974b-e8ed5f288e91) | ![Homatics Remote HO2](https://github.com/user-attachments/assets/67efb80a-22b9-4b40-a87f-984c1e4da084) | ![Homatics Remote HO3](https://github.com/user-attachments/assets/c48b125c-2d35-4887-97c6-c8c29d8d974d) | ![Homatics Remote HO4](https://github.com/user-attachments/assets/5a29c1e4-0cad-4bd9-a859-b6328cd48159) |\n| ------------- | ------------- | ------------- | ------------- |\n\n| ![Roku Voice Remote Pro](https://github.com/PRProd/HA-Firemote/assets/25486599/cfa82897-1a9c-4361-b9ce-59219fd94ca6) | ![Roku Voice Remote](https://github.com/PRProd/HA-Firemote/assets/25486599/0035d56c-59a7-4c81-8cd4-9cd1a1d10d14) | ![Roku Simple Remote](https://github.com/PRProd/HA-Firemote/assets/25486599/3f0b2def-9ef7-4af5-ab55-d7bda0a195b3) | ![Hisense Roku TV Remote](https://github.com/PRProd/HA-Firemote/assets/25486599/c9e526e2-9acf-4406-ae2d-1a1e8231ef2b) | ![TCL Roku TV Remote](https://github.com/PRProd/HA-Firemote/assets/25486599/1a33a82f-7abc-414a-ac96-1dc63dc73c62) | ![Westinghouse Roku TV Remote](https://github.com/PRProd/HA-Firemote/assets/25486599/4c8748dc-1881-4e33-9d55-d594143ddfeb) |\n| ------------- | ------------- | ------------- | ------------- | ------------- | ------------- |\n\n| ![App Launcher 1](https://github.com/PRProd/HA-Firemote/assets/25486599/63cda718-9eed-4259-8071-b272e3091f1d) | ![App Launcher 2](https://github.com/PRProd/HA-Firemote/assets/25486599/9531fd5f-9003-41f1-bc05-a6d3962e346b) |\n| ------------- | ------------- |\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## Introduction\n**Firemote** is a custom [Home Assistant](https://www.home-assistant.io/) card that is capable of controlling your media devices directly from any Home Assistant dashboard. The Firemote dashboard remotes are designed to look just like your physical remote controls, but they also contain TONS of customization options to choose from!\n\nFor a visual introduction, YouTube's [@BeardedTinker](https://www.youtube.com/@BeardedTinker) created a fantastic video about this card!\u003cbr\u003e\nhttps://www.youtube.com/watch?v=hbEHaspKvWs - Be sure to give him a sub and a like if you enjoy it!\u003cbr\u003e\n\nA full video demonstration of setup and use featuring a Homatics device can be found [here](https://www.youtube.com/watch?v=AggYjQ4vI-U)\u003cbr\u003e\n\nShort demonstration videos also exist for [Roku Firemote](https://www.youtube.com/watch?v=aZ9F4V9dAfQ) and [Chromecast Firemote](https://www.youtube.com/watch?v=LFnNewwKY8I)\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## Prerequisites\n* A functioning version of [Home Assistant](https://www.home-assistant.io/)\n* [HACS](https://peyanski.com/how-to-install-home-assistant-community-store-hacs/) (not required, but it makes things easier)\n* [A supported device](https://github.com/PRProd/HA-Firemote/wiki/Supported-Devices)\n  * [Amazon Fire Smart TV, Fire Stick, or Fire Cube](https://github.com/PRProd/HA-Firemote/wiki/Supported-Devices#amazon-fire-tv)\n  * [Apple TV](https://github.com/PRProd/HA-Firemote/wiki/Supported-Devices#apple-tv)\n  * [Chromecast](https://github.com/PRProd/HA-Firemote/wiki/Supported-Devices#chromecast)\n  * [Homatics](https://github.com/PRProd/HA-Firemote/wiki/Supported-Devices#homatics)\n  * [NVIDIA Shield](https://github.com/PRProd/HA-Firemote/wiki/Supported-Devices#nvidia-shield)\n  * [onn. Media Player](https://github.com/PRProd/HA-Firemote/wiki/Supported-Devices#onn-media-player)\n  * [Roku TV, and Media Player](https://github.com/PRProd/HA-Firemote/wiki/Supported-Devices#roku)\n  * [Xiaomi](https://github.com/PRProd/HA-Firemote/wiki/Supported-Devices#xiaomi)\n  * [Any device (advanced)](https://github.com/PRProd/HA-Firemote/wiki/entity:-none)\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## Download and Setup via Home Assistant UI \u0026 HACS\n1. Turn on ADB/USB/Network debugging on your Amazon, onn., Shield, Xiaomi, Chromecast, or Android TV device - [Video Tutorial](https://www.youtube.com/watch?v=XL7neKn1d-Y)\n    - For NVIDIA Shield users, be sure to turn on **Network debugging** (not shown in the video)\n    - (does not apply to Apple TV or Roku users)\n1. Connect your device to Home Assistant:\n   - Amazon, Chromecast, Shield, onn., Xiaomi, or Android TV users:\n     - Set up the Home Assistant [Android Debug Bridge Integration](https://www.home-assistant.io/integrations/androidtv/) and connect it to your device (**REQUIRED in every setup** [why?](https://github.com/PRProd/HA-Firemote/wiki#why-do-i-still-need-the-adb-integration-when-there-is-an-android-remote-integration))\n     - Optionally, for non Amazon Fire devices only, you may additionally choose to set up the Home Assistant [Android TV Remote Integration](https://www.home-assistant.io/integrations/androidtv_remote/) and connect it to your device. (optional)\n   - Apple TV Users\n     - Set up the Home Assistant [Apple TV Integration](https://www.home-assistant.io/integrations/apple_tv) and connect it to your device.  This will create a \"Media Player\" entity, and a \"Remote\" entity automatically.\n   - Roku Users\n     - Set up the Home Assistant [Roku Integration](https://www.home-assistant.io/integrations/roku) and connect it to your device.  This will create a \"Media Player\" entity, a \"Remote\" entity, and multiple others as well.\n1. Click on the HACS sidebar option, then type \"Firemote Card\" into the search bar\n1. Use the 3 dots on the right side of the search result to select **Download** or click on the search result then tap the DOWNLOAD button in the lower right.\n1. You will be prompted to reload your browser.  Click the **RELOAD** button to continue\n\n## OR Install Manually\n1. Turn on ADB/USB/Network debugging on your Amazon, Homatics, onn., Shield, Xiaomi, Chromecast, or Android TV device - [Video Tutorial](https://www.youtube.com/watch?v=XL7neKn1d-Y)\n    - For NVIDIA Shield users, be sure to turn on **Network debugging** (not shown in the video)\n    - (does not apply to Apple TV or Roku users)\n1. Connect your device to Home Assistant:\n   - Amazon, Chromecast, Homatics, Shield, onn., Xiaomi, or Android TV users:\n     - Set up the Home Assistant [Android Debug Bridge Integration](https://www.home-assistant.io/integrations/androidtv/) and connect it to your device (**REQUIRED in every setup** [why?](https://github.com/PRProd/HA-Firemote/wiki#why-do-i-still-need-the-adb-integration-when-there-is-an-android-remote-integration))\n     - Optionally, for non Amazon Fire devices only, you may additionally choose to set up the Home Assistant [Android TV Remote Integration](https://www.home-assistant.io/integrations/androidtv_remote/) and connect it to your device. (optional)\n   - Apple TV Users\n     - Set up the Home Assistant [Apple TV Integration](https://www.home-assistant.io/integrations/apple_tv) and connect it to your device.  This will create a \"Media Player\" entity, and a \"Remote\" entity automatically.\n   - Roku Users\n     - Set up the Home Assistant [Roku Integration](https://www.home-assistant.io/integrations/roku) and connect it to your device.  This will create a \"Media Player\" entity, a \"Remote\" entity, and multiple others as well.\n1. Download the contents of the [dist/](https://github.com/PRProd/HA-Firemote/blob/main/dist/) directory, and place it in your Home Assistant /config/www directory\n1. [Register the HA-Firemote.js file that you just installed as a new resource](https://developers.home-assistant.io/docs/frontend/custom-ui/registering-resources/)\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## How to use\n1. On any dashboard, click the +ADD CARD button\n1. Search by cards for \"Firemote Card\" and click on it - [help: It's not showing up](https://github.com/PRProd/HA-Firemote/wiki/Force-a-Refresh)\n1. Under the **Device Family** dropdown, choose \"Amazon Fire\", \"Apple TV\",  \"Chromecast\", \"Homatics\", \"NVIDIA Shield\", \"onn.\", \"Roku\", \"Xiaomi\", or \"[none/other](https://github.com/PRProd/HA-Firemote/wiki/entity:-none)\"\n   - Amazon, Chromecast, Shield, onn., Xiaomi, or Android TV users:\n     - Under **Device Model**, select the device model that you own. (Help: Which [Amazon Fire](https://developer.amazon.com/docs/fire-tv/device-specifications.html) or [NVIDIA Shield](https://www.nvidia.com/en-us/shield/)  device do I own?)\n     - 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.\n     - 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\n   - Apple TV Users\n     - Under **Apple TV Device Model**, select the device model that you own\n     - Under **Apple TV Media Player Entity**, select the Apple TV Media Player entity you wish to control\n     - 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\n   - Roku Users\n     - Under **Roku Device Model**, select the device model that you own\n     - Under **Roku Media Player Entity**, select the Roku Media Player entity you wish to control\n     - Under **Associated Roku Remote Entity**, select the Roku remote entity that is associated with the Roku Media Player Entity you chose in the previous step\n1. 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!\n\n![Config](https://github.com/PRProd/HA-Firemote/assets/25486599/9a4f061c-9584-44df-92f8-07d5e8346c6b)\n\n\n\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\n## Screenshots from Users\n![Dashboard](https://github.com/PRProd/HA-Firemote/assets/25486599/ddc0dc74-2b5d-47bd-b73f-05249dda3377)\u003cbr\u003e\n[Click here](https://github.com/PRProd/HA-Firemote/discussions/129) to see the full gallery\n\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\n## YAML card setup options\nExamples:\n```yaml\ntype: custom:firemote-card\nentity: media_player.fire_tv_192_168_1_30\ndevice_family: amazon-fire\ndevice_type: fire_tv_4_series\ncompatibility_mode: default\napp_launch_1: prime-video\napp_launch_2: netflix\napp_launch_3: hdmi_1\napp_launch_4: youtube\nhdmi_1: Cable\nscale: 85\n```\n```yaml\ntype: custom:firemote-card\nentity: media_player.apple_tv_4k_2nd_gen\ndevice_family: apple-tv\ndevice_type: appletv-4k-gen2\ncompatibility_mode: default\napple_tv_remote_entity: remote.apple_tv_4k_2nd_gen\napp_launch_1: apple-appstore\napp_launch_2: apple-tv-arcade\napp_launch_3: mlb\napp_launch_4: nfl\nvisible_name_text: Game Room\nname_position: top\nbutton_overrides:\n  mute-button:\n    script: receiver_mute_script\n```\n```yaml\ntype: custom:firemote-card\nentity: media_player.android_tv_192_168_107_209\ndevice_family: nvidia-shield\ndevice_type: shield-tv-pro-2019\ncompatibility_mode: default\nandroid_tv_remote_entity: remote.shield\nscale: '100'\napp_launch_1: netflix\napp_launch_2: function-find-my-remote\napp_launch_3: function-mute\n```\n\nOptions:\n| Name                   | Type   | Required | Options                                                          | Description                            |\n| ---------------------- | ------ | -------- | ---------------------------------------------------------------- | -------------------------------------- |\n| type                   | string | yes      | custom:firemote-card                                             | Type of the card                       |\n| entity                 | string | yes      | any valid media player entity created in the [Android Debug Bridge Integration](https://www.home-assistant.io/integrations/androidtv/), [Apple TV Integration](https://www.home-assistant.io/integrations/apple_tv) or the [Roku Integration](https://www.home-assistant.io/integrations/roku) or [none](https://github.com/PRProd/HA-Firemote/wiki/entity:-none)| entity_id                              |\n| device_family          | string | yes      | amazon-fire\u003cbr\u003eapple-tv\u003cbr\u003echromecast\u003cbr\u003envidia-shield\u003cbr\u003eonn\u003cbr\u003eroku\u003cbr\u003exiaomi\u003cbr\u003e[none](https://github.com/PRProd/HA-Firemote/wiki/entity:-none) | Manufacturer Family            |\n|android_tv_remote_entity| string | no       | any valid entity created in the [Android TV Remote Integration](https://www.home-assistant.io/integrations/androidtv_remote/) | entity_id\u003cbr\u003eIgnored in Apple TV and Roku configurations |\n| apple_tv_remote_entity | string | yes*     | any valid remote entity created in the [Apple TV Integration](https://www.home-assistant.io/integrations/apple_tv)  | entity_id\u003cbr\u003e* Required ONLY in Apple TV configurations |\n| roku_remote_entity     | string | yes*     | any valid remote entity created in the [Roku Integration](https://www.home-assistant.io/integrations/roku/)  | entity_id\u003cbr\u003e* Required ONLY in Roku configurations |\n| device_type            | string | yes      | [appletv-4k-gen3](https://support.apple.com/kb/SP886)\u003cbr\u003e[appletv-4k-gen2](https://support.apple.com/kb/SP845)\u003cbr\u003e[appletv-4k-gen1](https://support.apple.com/kb/SP769)\u003cbr\u003e[appletv-gen4](https://support.apple.com/kb/SP724)\u003cbr\u003e[appletv-gen3](https://support.apple.com/kb/SP648)\u003cbr\u003e[appletv-gen2](https://support.apple.com/kb/SP598)\u003cbr\u003e[appletv-gen1](https://support.apple.com/kb/SP19)\u003cbr\u003echromecast-4k\u003cbr\u003e[fire_tv_toshiba_v35](https://github.com/PRProd/HA-Firemote/wiki/Smart-TV---Toshiba-V35-Series-LED-FHD-HD---Fire-TV-(2021)) \u003cbr\u003e [fire_tv_4_series](https://github.com/PRProd/HA-Firemote/wiki/Smart-TV---Fire-TV-4-Series-(2021)) \u003cbr\u003e fire_tv_jvc-4k-2021 \u003cbr\u003e fire_tv_insignia_f20 \u003cbr\u003e [fire_tv_cube_third_gen](https://github.com/PRProd/HA-Firemote/wiki/Fire-TV-Cube---3rd-Gen-(2022)) \u003cbr\u003e [fire_tv_cube_second_gen](https://github.com/PRProd/HA-Firemote/wiki/Fire-TV-Cube---2nd-Gen-(2019)) \u003cbr\u003e [fire_tv_cube_first_gen](https://github.com/PRProd/HA-Firemote/wiki/Fire-TV-Cube---1st-Gen-(2018)) \u003cbr\u003e [fire_tv_stick_4k_max_second_gen](https://github.com/PRProd/HA-Firemote/wiki/Fire-TV-Stick-4K-Max-2nd-Gen-(2023)) \u003cbr\u003e [fire_tv_stick_4k_second_gen](https://github.com/PRProd/HA-Firemote/wiki/Fire-TV-Stick-4K-2nd-Gen-(2023)) \u003cbr\u003e[fire_tv_stick_4k_max](https://github.com/PRProd/HA-Firemote/wiki/Fire-TV-Stick-4K-Max---1st-Gen-(2021)) \u003cbr\u003e [fire_tv_3rd_gen](https://github.com/PRProd/HA-Firemote/wiki/Fire-TV-Stick---3rd-Gen-(2020)) \u003cbr\u003e [fire_tv_stick_lite](https://github.com/PRProd/HA-Firemote/wiki/Fire-TV-Stick-Lite---1st-Gen-(2020)) \u003cbr\u003e [fire_stick_4k](https://github.com/PRProd/HA-Firemote/wiki/Fire-TV-Stick-4K---1st-Gen-(2018)) \u003cbr\u003e [fire_stick_second_gen](https://github.com/PRProd/HA-Firemote/wiki/Fire-TV-Stick---2nd-Gen-(2016---2019)) \u003cbr\u003e [fire_stick_first_gen](https://github.com/PRProd/HA-Firemote/wiki/Fire-TV-Stick-1st-Gen-(2014)) \u003cbr\u003e [fire_tv_second_gen_2015](https://github.com/PRProd/HA-Firemote/wiki/Fire-TV-%E2%80%90-2nd-Gen-(2015)) \u003cbr\u003e [box-4-4k-plus](https://github.com/PRProd/HA-Firemote/wiki/Homatics-Box-R-4K-Plus) \u003cbr\u003e dune-hd-box-4-4k-plus \u003cbr\u003e  onn-streaming-device-4k-pro \u003cbr\u003e [onn-4k-streaming-box](https://github.com/PRProd/HA-Firemote/wiki/onn.-Google-TV-4K-Streaming-Box-(2023)) \u003cbr\u003e onn-full-hd-streaming-stick \u003cbr\u003e roku-streambar-pro \u003cbr\u003e roku-streambar \u003cbr\u003e roku-ultra-lt-2023 \u003cbr\u003e roku-ultra-lt \u003cbr\u003e roku-ultra-2020 \u003cbr\u003e roku-streaming-stick-4k \u003cbr\u003e roku-express-4k-plus \u003cbr\u003e roku-express-4k \u003cbr\u003e roku-express \u003cbr\u003e roku-premiere \u003cbr\u003e roku-generic-hisense \u003cbr\u003e roku-generic-tcl \u003cbr\u003e roku-generic-westinghouse \u003cbr\u003e shield-tv-2017 \u003cbr\u003e shield-tv-pro-2017 \u003cbr\u003e shield-tv-2019 \u003cbr\u003e shield-tv-pro-2019 \u003cbr\u003e mi-box-s \u003cbr\u003e xiaomi-tv-stick-4k \u003cbr\u003e [other](https://github.com/PRProd/HA-Firemote/wiki/entity:-none)| The type of device you are controlling\u003cbr\u003e[Which devices are supported?](https://github.com/PRProd/HA-Firemote/wiki/Supported-Devices) |\n| compatibility_mode | string | no | default \u003cbr\u003e strong \u003cbr\u003e event0 \u003cbr\u003e event1 \u003cbr\u003e event2 \u003cbr\u003e event3 \u003cbr\u003e event4 \u003cbr\u003e event5 \u003cbr\u003e event6 \u003cbr\u003e event7 \u003cbr\u003e event8 \u003cbr\u003e event9 \u003cbr\u003e event10 \u003cbr\u003e event11 \u003cbr\u003e event12 \u003cbr\u003e event13 | Adjust this value only if your buttons are completely unresponsive\u003cbr\u003e\u003cbr\u003eIgnored in Apple TV configurations\u003cbr\u003e\u003cbr\u003e[FAQ Available for additional help](https://github.com/PRProd/HA-Firemote#faq) |\n|defaultRemoteStyle_override | string | no | AF1 \u003cbr\u003e AF2 \u003cbr\u003e AF3 \u003cbr\u003e AF4 \u003cbr\u003e AF5 \u003cbr\u003e AF6 \u003cbr\u003e AFJTV \u003cbr\u003e AFXF2 \u003cbr\u003e AR1 \u003cbr\u003e AR2 \u003cbr\u003e AR3 \u003cbr\u003e CC1 \u003cbr\u003e CC2 \u003cbr\u003e CC3 \u003cbr\u003e HO1 \u003cbr\u003e HO2 \u003cbr\u003e HO3 \u003cbr\u003e HO4 \u003cbr\u003e NS1 \u003cbr\u003e NS2 \u003cbr\u003e ON1 \u003cbr\u003e ON2 \u003cbr\u003e RVRP \u003cbr\u003e RVR \u003cbr\u003e RSR \u003cbr\u003e RHR \u003cbr\u003e RTR \u003cbr\u003e RWR \u003cbr\u003e XM1 \u003cbr\u003e XM2 \u003cbr\u003e AL1 \u003cbr\u003e AL2 | Optionally select a style of remote different from the one that shipped with your device |\n| app_launch_1\u003cbr\u003eapp_launch_2\u003cbr\u003eapp_launch_3\u003cbr\u003eapp_launch_4\u003cbr\u003eapp_launch_5\u003cbr\u003eetc... | string | no | [ See App Launch Button Customization section for options](#app-launch-button-customization) | Quick launch apps customization |\n|hdmi_1\u003cbr\u003ehdmi_2\u003cbr\u003ehdmi_3\u003c/br\u003ehdmi_4| string | no | Personalized name for this HDMI input | The name entered here will appear on the button (truncated to 8 characters to fit) |\n| scale       | integer| no       | Any positive number                                           | Change the size of this card by percentage. The default size is 100 |\n| custom_launchers | object | no | Create your own app launcher buttons        | Details are in the [Launcher Button Customizations](https://github.com/PRProd/HA-Firemote#launcher-button-customizations) of the [README.md](https://github.com/PRProd/HA-Firemote/blob/main/README.md) file |\n| button_overrides | object | no | Button name and HA script name are required.| Details are in the Button Overrides section of the [README.md](https://github.com/PRProd/HA-Firemote#button-overrides) file |\n| visible_name_text       | string | no      | Any text                                                         | Optional device label for your firemote |\n| name_position           | string | no      | hidden\u003cbr\u003ebottom\u003cbr\u003etop\u003cbr\u003e                                      | Position for your optional device label |\n| visible_name_text_color | hex color value | no | Any hex color value e.g.: #ffffff                            | Optional text color for the device name label |\n| show_version_number     | bool   | no      | true\u003cbr\u003efalse                                                    | Optionally display the Firemote Version number on the card |\n| hide_button_highlights  | bool   | no      | true\u003cbr\u003efalse                                                    | Optionally hide the status higlighting decorations for the power, home, and play/pause buttons |\n| use_theme_background    | bool   | no      | true\u003cbr\u003efalse                                                    | Optionally hide the AL1 or AL2 remote style's background color to let the HA theme color show |\n| hide_button_group_frame | bool   | no      | true\u003cbr\u003efalse                                                    | Optionally hide the frames around the button groups when using AL1 or AL2 |\n| useCustomSkin           | bool   | no      | true\u003cbr\u003efalse                                                    | Toggle a custom background skin color on or off when using AL1 or AL2 |\n| show_media_controls     | bool   | no      | true\u003cbr\u003efalse                                                    | Show additional media control buttons for Chromecast style remotes CC1, CC2, or CC3 |\n| skin                    | hex color value | no | Any hex color value e.g.: #ffffff                            | background skin color for AL1 or AL2 |\n| dpad_style              | string | no      | amazon-fire\u003cbr\u003eapple-tv-black\u003cbr\u003eapple-tv-silver\u003cbr\u003echromecast\u003cbr\u003exiaomi\u003cbr\u003eminimal | Dpad style options for AL1 or AL2 |\n\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\n## App Launcher Buttons\nCustom 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](https://github.com/PRProd/HA-Firemote/issues) button on the top of this page, and select the [App Shortcut Request](https://github.com/PRProd/HA-Firemote/issues/new?assignees=PRProd\u0026labels=New+App+Shortcut%2Cenhancement\u0026projects=\u0026template=App_Shortcut_Request.yaml\u0026title=%5BNew+App+Shortcut%5D%3A+) option.  There are currently [**over 330** options available](https://github.com/PRProd/HA-Firemote/wiki/Firemote-App-Launchers), and the list just keeps growing.\n\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\n## Launcher Button Customizations\nYou are not limited to only using the launcher buttons that come with Firemote.  Through YAML, you can define your own working buttons in one of two ways: defining a script or constructing an action call.\n\nExample:\n```yaml\ntype: custom:firemote-card\nentity: media_player.fire_tv_192_168_107_88\ndevice_family: amazon-fire\ndevice_type: fire_tv_4_series\ncompatibility_mode: default\ncustom_launchers:\n  - friendly_name: flash the light\n    label: FLASH\n    image_path: https://upload.wikimedia.org/wikipedia/commons/2/28/Flash-outlined-thin-circular-button.svg\n    color: red\n    background: white\n    script: flashthelablight\n    data:\n      color: green\n  - friendly_name: Red Lamp\n    label: red\n    icon: mdi:lamp\n    color: red\n    background: blue\n    action: light.toggle\n    target:\n      entity_id: light.bedroom_lamp\n    data:\n      color_name: red\n      transition: 2\n      brightness_pct: 100\napp_launch_1: customlauncher flash the light\napp_launch_2: customlauncher Red Lamp\nscale: '110'\n```\n\u003cbr\u003e\n\nYAML usage:\n| Key           | Value           | Required                  | Description                                                                     |\n| ------------- | --------------- | ------------------------- | ------------------------------------------------------------------------------- |\n| friendly_name | string          | yes                       | This is the name that will appear in the GUI app selector dropdown              |\n| label         | string          | no                        | The text that will appear on the button                                         |\n| icon          | mdi icon name   | no                        | a valid mdi icon name\u003cbr\u003e ex: mdi:lamp                                          |\n| image_path    | url             | no                        | path to an image resource                                                       |\n| color         | css color value | no                        | custom color for your text label or your mdi icon\u003cbr\u003eex: white\u003cbr\u003eex: '#ff0000' |\n| background    | css color value | no                        | custom color for your button's background\u003cbr\u003eex: green\u003cbr\u003eex: '#ffffff'         |\n| script        | string          | yes if calling a script   | The name of your Home Assistant script                                          |\n| action        | string          | yes if not using a script | The name of the Home Assistant action you want to call                          |\n| target        | object          | yes if not using a script | Define the entity for your action to act upon                                   |\n| data          | object          | no                        | optional parameters for your action, or script variables                        |\n\n\nOnce defined, a custom button can be assigned to a Firemote button location through the YAML config itself, or it can be selected through the Visual Editor dropdown\n\n![image](https://github.com/PRProd/HA-Firemote/assets/25486599/ce6ccb6c-fae1-4757-8ee8-087831e4b5b5)\n\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\n## Button Overrides\nButton Overrides can be very useful for customization.  These overrides can be used to call a Home Assistant action directly, run a script, or hide a button on your remote.  These options are accomplished through your Firemote's YAML configuration.  Just like launcher button customizations, you can also include a data parameter with your action or for your script.\n\nConsider this example:\n```yaml\nbutton_overrides:\n  mute-button:\n    script: receiver_mute_script\n  volume-down-button:\n    script: receiver_volume_down_script\n  volume-up-button:\n    action: light.toggle\n    target:\n      entity_id: light.bedroom_lamp\n    data:\n      color_name: red\n      transition: 2\n      brightness_pct: 100\n  power-button:\n    hidden: true\n```\n\u003cdetails\u003e\n  \u003csummary\u003eValid button names are listed here:\u003c/summary\u003e\n\n - app-switch-button\n - apps-button\n - back-button\n - blue-button\n - center-button\n - channel-down-button\n - channel-up-button\n - down-button\n - fastforward-button\n - green-button\n - hamburger-button\n - headset-button\n - home-button\n - input-button\n - keyboard-button\n - left-button\n - live-button\n - magic-star-button\n - mute-button\n - num1-button\n - num2-button\n - num3-button\n - num4-button\n - num5-button\n - num6-button\n - num7-button\n - num8-button\n - num9-button\n - num0-button\n - options-button\n - patchwall-button\n - playpause-button\n - power-button\n - profile-button\n - programmable-one-button\n - programmable-two-button\n - red-button\n - restart-button\n - replay-button\n - rewind-button\n - right-button\n - search-button\n - settings-button\n - sleep-button\n - subtitle-button\n - tv-button\n - up-button\n - voice-button\n - volume-down-button\n - volume-up-button\n - yellow-button\n\n\u003c/details\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\n## FAQ\n\nAdditional FAQs can be found [here](https://github.com/PRProd/HA-Firemote/wiki#faq) in the [Firemote Wiki](https://github.com/PRProd/HA-Firemote/wiki)\n\u003cbr\u003e\n\u003cbr\u003e\n\n### I installed the Firemote Card, but I can't find it to add in my dashboard\nThis tends to happen when your Home Assistant UI needs a refresh.  The best way to do this is through [force clearing your Home Assistant cache](https://github.com/PRProd/HA-Firemote/wiki/Force-a-Refresh) and trying again.\n\u003cbr\u003e\u003cbr\u003e\n\n###  Why won't the volume, mute, and/or power buttons work from my Firemote card?\nIn 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.\n\u003cbr\u003e\n\nIf 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](https://github.com/PRProd/HA-Firemote/wiki/Using-CEC-Controls) to learn more about how to [configure CEC to work with your Firemote](https://github.com/PRProd/HA-Firemote/wiki/Using-CEC-Controls).  Another option might be to control your devices (TVs, Receivers, etc.) using [Button Overrides](https://github.com/PRProd/HA-Firemote#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.\n\u003cbr\u003e\n\nDue 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](https://github.com/PRProd/HA-Firemote#button-overrides) will be required in this case.\n\u003cbr\u003e\n\u003cbr\u003e\n\n### Why don't any of the buttons on the Firemote work at all? ###\n * 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.\n * Check your card configuration:\n   * Is the correct Android device selected?\n   * Is the correct Device Family selected?\n   * Is the correct Device type selected?\n   * If you are using one, is the correct matching Android TV Remote Entity selected?\n   * Is Compatibility Mode set to Default?\n * 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.\n\u003cbr\u003e\n\n### I own a device that isn't a part of any of the existing device families, can it be added?\nYes!  In fact, there is a poll in the discussion group called [Vote for what gets added next](https://github.com/PRProd/HA-Firemote/discussions/41) where the community can help decide which new device family will gain Firemote support next.  If your device isn't on the ballot, no problem!  Just vote for \"Other\" and write the name of your device in the discussion thread below.\n\u003cbr\u003e\n\u003cbr\u003e\n\n### Why isn't the model of my Amazon Fire Device supported?\nThere 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.\u003cbr\u003e\n\nThe **BEST** option for everyone is if you would submit a request to have your device added!  It's simple!  Just open a new [Amazon Fire TV Device Support Request](https://github.com/PRProd/HA-Firemote/issues/new?assignees=PRProd\u0026labels=New+Device+Support%2Cenhancement\u0026projects=\u0026template=device_support_request.yaml\u0026title=%5BAmazon+Fire+TV+Device+Support%5D%3A+), fill out the quick and easy form, and you're done!\n\u003cbr\u003e\n\u003cbr\u003e\n\n### Why do only some of the Firemote buttons for the Apps that came with my Apple TV work properly, while others don't?\nApple 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 open a [new language support request](https://github.com/PRProd/HA-Firemote/issues/new?assignees=PRProd\u0026labels=Region+Issue%2Cenhancement\u0026projects=\u0026template=New_Language_Support.yaml\u0026title=%5BNew+Language+Support%5D%3A+) so we can work together and make all of these buttons work as intended.\n\u003cbr\u003e\n\u003cbr\u003e\n\n### I want a shortcut button for an app I use frequently, but it's not on the list.  Can it be added?\nAbsolutely!  Simply ask!  Here's how: From the [Issues](https://github.com/PRProd/HA-Firemote/issues) menu, simply start a new [App Shortcut Request](https://github.com/PRProd/HA-Firemote/issues/new?assignees=PRProd\u0026labels=New+App+Shortcut%2Cenhancement\u0026projects=\u0026template=App_Shortcut_Request.yaml\u0026title=%5BNew+App+Shortcut%5D%3A+).  If you absolutely cannot wait, you can also [build your own launcher button](https://github.com/PRProd/HA-Firemote#launcher-button-customizations) using YAML.\n\u003cbr\u003e\n\u003cbr\u003e\n\n### How do I report a problem, make a request, or talk about stuff?\nClick on the [Issues](https://github.com/PRProd/HA-Firemote/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](https://github.com/PRProd/HA-Firemote/discussions) if that suits your needs.\n\u003cbr\u003e\n\u003cbr\u003e\n\n### How can I contribute?\n - Did you install Firemote through HACS?  If you did, and it was easy, visit the [HACS Github Page](https://github.com/hacs/default) and give their project a star!  There should be thousands, but for some reason they don't have many.  Give them some love!\n - Do you speak a language other than English that is not [already supported](https://github.com/PRProd/HA-Firemote/wiki/#which-languages-are-currently-supported)?  You can help out the community by filling out a [new language support request](https://github.com/PRProd/HA-Firemote/issues/new?assignees=PRProd\u0026labels=Region+Issue%2Cenhancement\u0026projects=\u0026template=New_Language_Support.yaml\u0026title=%5BNew+Language+Support%5D%3A+).\n - Take a look at the current [discussions board](https://github.com/PRProd/HA-Firemote/discussions) to see if anything is tagged with \"Help Wanted\".\n - \u003ca href=\"https://www.buymeacoffee.com/PRProd\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/default-orange.png\" alt=\"Buy Me A Coffee\" height=\"41\" width=\"174\"\u003e\u003c/a\u003e\n - 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)](https://www.amazon.com/hz/wishlist/ls/2UDS10RPJ6F5K?ref_=wl_share) and an [Amazon Wish List (DE)](https://www.amazon.de/hz/wishlist/ls/HFABU3R70GWE?ref_=wl_share) for any of you who are feeling incredibly generous and want to send me something that I don't already own.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPRProd%2FHA-Firemote","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPRProd%2FHA-Firemote","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPRProd%2FHA-Firemote/lists"}