{"id":13905881,"url":"https://github.com/codefaktor/FTVLaunchX","last_synced_at":"2025-07-18T03:32:28.293Z","repository":{"id":48091941,"uuid":"234797094","full_name":"codefaktor/FTVLaunchX","owner":"codefaktor","description":"Simple helper application to allow custom launchers on Amazon Fire TV devices.","archived":false,"fork":false,"pushed_at":"2020-08-31T14:31:05.000Z","size":470,"stargazers_count":191,"open_issues_count":7,"forks_count":11,"subscribers_count":17,"default_branch":"develop","last_synced_at":"2024-08-07T23:45:38.451Z","etag":null,"topics":["android-tv","androidtv","fire-tv","firetv","leanback","leanback-launcher"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codefaktor.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://paypal.me/pools/c/8lNMBi7om0","https://blockchain.com/btc/address/1BcFNaen3nAPKyGmKG7cbEJWut2siijJPJ"]}},"created_at":"2020-01-18T21:00:05.000Z","updated_at":"2024-07-15T04:16:34.000Z","dependencies_parsed_at":"2022-08-12T18:30:40.519Z","dependency_job_id":null,"html_url":"https://github.com/codefaktor/FTVLaunchX","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codefaktor%2FFTVLaunchX","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codefaktor%2FFTVLaunchX/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codefaktor%2FFTVLaunchX/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codefaktor%2FFTVLaunchX/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codefaktor","download_url":"https://codeload.github.com/codefaktor/FTVLaunchX/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226344450,"owners_count":17610137,"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":["android-tv","androidtv","fire-tv","firetv","leanback","leanback-launcher"],"created_at":"2024-08-06T23:01:25.720Z","updated_at":"2024-11-25T14:30:30.973Z","avatar_url":"https://github.com/codefaktor.png","language":"Java","readme":"FTVLaunchX — README\n===================\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./app/src/main/res/mipmap-xxhdpi/ic_launcher.png\" /\u003e\n\u003c/p\u003e\n\nAbout\n-----\n\nFTVLaunchX is a simple helper application to allow custom launchers on\nAmazon Fire TV devices.\n\nIt is inspired by the famous\n[LauncherHijack](https://github.com/BaronKiko/LauncherHijack) of @BaronKiko\nand tries to overcome several issues relating to it.\n\n- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -\n\n**NOTE: due to changes in FireOS 6.2.7.2+ FTVLaunchX is no longer working!**\n\nI am trying to find a fix but I can't promise anything just yet... :-/\n\nStay tuned at [issue #4](https://github.com/codefaktor/FTVLaunchX/issues/4).\n\n- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -\n\nSo far FTVLaunchX has been tested on:\n\n-   Fire TV Stick 2nd Generation (Fire OS 5.2.7.2, Android 5.1)\n-   Fire TV Stick 4K (Fire OS 6.2.6.8, Android 7.1)\n-   Fire TV Cube 2nd Generation (Fire OS 7.2.0.6, Android 9.0)\n-   Nvidia Shield 2017 (Shield Android TV 8.0.1)\n-   Sony XG 9505 TV (Android 9.x)\n-   Toshiba TV Fire TV Edition (Fire OS 6.2.6.9)\n\nPlease let me know if you are using it successfully on any other devices.\n\nYou can find me at the\n[official discussion thread](https://forum.xda-developers.com/fire-tv/general/ftvlaunchx-custom-launcher-root-t4037397)\non XDA.\n\n**A word To Amazon:** we all understand that you want to display some ads,\npresent your content and sell Amazon Prime but the current incarnation of the\nFire TV home screen is just too bloated and barely usable by young children\nor elderly people.\n\n**Amazon, please, before trying to kill this project, think about giving us\na way to customize and clean up the home screen – presenting 50 pieces of\ninformation on one screen is just not a good user experience! Thank you!**\n\n### Features\n\n-   Reliably intercepts any \u0026 all presses of the home button.\n\n-   Starts the selected launcher on boot (note that this can take\n    up to a minute on older devices).\n\n-   Starts the selected launcher when waking up from sleep.\n\n-   Allows use of the original long-press-on-home functionality\n    by holding down the menu key in parallel.\n\n-   Works with any launcher or other app like e.g.\n    -   [Android TV Launcher](https://leanback-launcher.en.aptoide.com/)\n    -   [Leanback Launcher](https://github.com/tsynik/LeanbackLauncher)\n    -   [TV Launcher 3](https://tvlauncher.en.aptoide.com/)\n    -   [Kodi](https://kodi.tv/)\n\n#### Known Limitations\n\n-   When a screensaver is running then the home button does not cause\n    the screensaver to exit, all other buttons do work though.\n\n-   Long-pressing the home button had to be replaced by a custom key\n    combination (holding down the menu key in parallel).\n\nPlease let me know if you find any other issues by opening a bug report at\nthe [issue tracker][GITHUB_ISSUES] here at GitHub – you are also very welcome\nto send in any feature requests.\n\n### Donations\n\nFTVLaunchX is and will always be totally **free** and **without ads**.\n\nBut if you want to say _Thank You_ and would like to support any further\ndevelopment then feel free to send me a buck via PayPal or Bitcoin:\n\n-   [FTVLaunchX MoneyPool at PayPal](https://paypal.me/pools/c/8lNMBi7om0)\n-   [FTVLaunchX Bitcoin Address](https://blockchain.com/btc/address/1BcFNaen3nAPKyGmKG7cbEJWut2siijJPJ)\n\nYou can also help me out by downloading \u0026 using the Brave browser or,\nwhen you are already using Brave, by tipping me some BAT directly at my\n[personal GitHub profile](https://github.com/ErikAbele).\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://brave.com/eri226\" title=\"Download Brave\"\u003e\n        \u003cimg src=\"https://brave.com/wp-content/uploads/2018/02/switch_banner_2@2x.png\" /\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\nNote: you will have to use Brave minimally for at least one month so that\nI get credited the referral bonus.\n\n\nDocumentation\n-------------\n\n### Setup\n\n#### Downloads\n\nAll releases of FTVLaunchX can be downloaded as installable APKs from the\n[release page][GITHUB_RELEASES].\n\nIf you are using [Aptoide TV](https://tv.aptoide.com/) on your Fire TV\ndevice you can also download it directly from\n[there](https://launchx.en.aptoide.com/).\n\n#### Quick Installation Overview\n\nFTVLaunchX needs the `WRITE_SECURE_SETTINGS` permission to enable an\naccessibility service on your Fire TV device.\n\nIf you know what you are doing then simply grant this permission by executing\nthe following command in an `ADB` shell on your device:\n```\n$ pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS\n```\n\nFor a step-by-step guide and more information on how to connect to your\nFire TV device via `ADB`, follow the detailed installation instructions below.\n\n**Note to users of Fire TV Cube 2nd Generation:** the `WRITE_SECURE_SETTINGS`\npermission seems to have been removed by Amazon; please manually enable the\naccessibility service of FTVLaunchX via the following two commands:\n```\n$ settings put secure enabled_accessibility_services de.codefaktor.ftvlaunchx/de.codefaktor.ftvlaunchx.HomeService\n$ settings put secure accessibility_enabled 1\n```\n\n#### Detailed Installation Instructions\n\nThere are three ways to install FTVLaunchX: either directly on your Fire TV\ndevice via e.g. the Downloader app or, alternatively with the help of `ADB`\nfrom a mobile phone running Android or a desktop PC.\n\n##### Pre-Requisites\n\n1.  From the main screen of your Fire TV select _Settings_\n2.  Select _My Fire TV_ \u003e _Developer Options_\n3.  Turn on _ADB Debugging_\n4.  Turn on _Apps from Unknown Sources_\n5.  Go back to _My Fire TV_ \u003e _About_ \u003e _Network_\n6.  Note the IP address of your device; you will need this later on\n\n##### Method 1: directly on Fire TV\n\n1.  Install the Downloader app from the Amazon App Store on your\n    Fire TV device\n2.  Open Downloader and navigate to\n    `github.com/codefaktor/FTVLaunchX/releases`\n3.  Find, download and install the latest release of FTVLaunchX\n4.  Open Downloader and navigate to\n    `troypoint.com/radb`\n5.  The download should start automatically; click `Install`, then `Open`\n6.  Follow the on-screen instructions and enter the IP address of your\n    device when asked (see 6. in Pre-Requisites above)\n7.  When presented with a command-line within the `Remote ADB Shell`\n    application, enter and run the following command:\n    ```\n    pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS\n    ```\n    or on devices based on Fire OS 7 (e.g. Fire TV Cube 2nd Generation):\n    ```\n    settings put secure enabled_accessibility_services de.codefaktor.ftvlaunchx/de.codefaktor.ftvlaunchx.HomeService\n    settings put secure accessibility_enabled 1\n    ```\n8.  Open FTVLaunchX, select a launcher and press the home button – enjoy!\n\n##### Method 2: via ADB from an Android phone\n\n1.  Use a browser to download the latest release of FTVLaunchX from the\n    [release page][GITHUB_RELEASES] to your phone\n2.  Install the [Easy Fire Tools](https://play.google.com/store/apps/details?id=de.agondev.easyfiretools)\n    application from Google Play on your phone\n3.  Install the [Remote ADB Shell](https://play.google.com/store/apps/details?id=com.cgutman.androidremotedebugger)\n    application from Google Play on your phone\n4.  Open `Easy Fire Tools`, discover \u0026 connect to your Fire TV and install\n    the downloaded release of FTVLaunchX\n5.  Open `Remote ADB Shell`, connect to your Fire TV by using the IP address\n    of your device (see 6. in Pre-Requisites above) and run the following\n    command:\n    ```\n    pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS\n    ```\n    or on devices based on Fire OS 7 (e.g. Fire TV Cube 2nd Generation):\n    ```\n    settings put secure enabled_accessibility_services de.codefaktor.ftvlaunchx/de.codefaktor.ftvlaunchx.HomeService\n    settings put secure accessibility_enabled 1\n    ```\n6.  Open FTVLaunchX on your Fire TV device, select a launcher and press the\n    home button – enjoy!\n\n##### Method 3: via ADB from a desktop PC or laptop\n\n1.  Use a browser to download the latest release of FTVLaunchX from the\n    [release page][GITHUB_RELEASES] to your computer\n2.  Install `ADB` and connect to your Fire TV by using the IP address\n    of your device (see 6. in Pre-Requisites above), see\n    [here](https://developer.amazon.com/docs/fire-tv/connecting-adb-to-device.html)\n    for detailed instructions on how to do this\n3.  Install the downloaded release of FTVLaunchX by executing one of the\n    following commands (make sure to use the actual name of the downloaded\n    file):\n    -   For devices running Fire OS 5 (e.g. Fire TV Stick 2nd Generation)\n    ```\n    adb install FTVLaunchX-x.y.z.apk\n    adb shell pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS\n    ```\n    -   For devices running Fire OS 6 (e.g. Fire TV Stick 4K)\n    ```\n    adb install -g FTVLaunchX-x.y.z.apk\n    ```\n    -   For devices running Fire OS 7 (e.g. Fire TV Cube 2nd Generation)\n    ```\n    adb install FTVLaunchX-x.y.z.apk\n    adb shell settings put secure enabled_accessibility_services de.codefaktor.ftvlaunchx/de.codefaktor.ftvlaunchx.HomeService\n    adb shell settings put secure accessibility_enabled 1\n    ```\n4.  Open FTVLaunchX on your Fire TV device, select a launcher and press the\n    home button – enjoy!\n\nNote: if you are updating FTVLaunchX with this method then you will need to\nadd the `-r` flag to the `adb install` commands in step 3.\n\n### Usage\n\nJust start FTVLaunchX and select the application to use as your launcher:\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./gfx/Screenshot.jpg\" width=\"640\" height=\"360\" /\u003e\n\u003c/p\u003e\n\nFrom now on, every time you boot your device, wake it up from sleep or press\nthe home button, you will be taken to this application.\n\nAs long as no launcher has been selected, FTVLaunchX will open itself.\n\n#### The long-press-on-home menu\n\nTo access the original long-press-on-home menu or to open the settings menu\nof your Fire TV device, you will have to press and hold the menu and home\nbuttons at the same time.\n\nYou can also get to the default Amazon home screen by using this method.\n\nAnd, of course, you can also still use Alexa to get to the settings menu or\nthe original Amazon home screen: just say \"Home\" or \"Settings\".\n\nLean back \u0026 enjoy!\n\n\nCopyright\n---------\n\nCopyright © 2020 [Erik Abele](http://www.codefaktor.de/).\n\nAll rights not explicitly granted by the [LICENSE][] are reserved.\n\n\nLicense\n-------\n\nLicensed under the Apache License, Version 2.0 (the \"License\").\n\nA copy of the License is included in the \"[LICENSE][]\" text file;\nyou may also obtain a copy at\n\n  \u003e \u003chttp://www.apache.org/licenses/LICENSE-2.0\u003e\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\nSee the License for the specific language governing permissions and\nlimitations under the License.\n\n- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -\n\n[LICENSE]: ./LICENSE\n\n[GITHUB_ISSUES]: https://github.com/codefaktor/FTVLaunchX/issues\n[GITHUB_RELEASES]: https://github.com/codefaktor/FTVLaunchX/releases\n","funding_links":["https://paypal.me/pools/c/8lNMBi7om0","https://blockchain.com/btc/address/1BcFNaen3nAPKyGmKG7cbEJWut2siijJPJ"],"categories":["HarmonyOS"],"sub_categories":["Windows Manager"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodefaktor%2FFTVLaunchX","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodefaktor%2FFTVLaunchX","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodefaktor%2FFTVLaunchX/lists"}