Skip to content

Commit

Permalink
Merge branch 'release/1.0.1'.
Browse files Browse the repository at this point in the history
* release/1.0.1:
  Prepare '1.0.1' release.
  Add note about downloads from Aptoide.
  Add large variant of banner & icon.
  Raise priority of boot receiver.
  Add link to XDA & extend list of tested devices.
  Update README.
  Add screenshot.
  Fix formatting and links.
  Resume development at '1.0.1-dev'.
  • Loading branch information
ErikAbele committed Jan 21, 2020
2 parents 6154b10 + 38c60c1 commit 3b103b9
Show file tree
Hide file tree
Showing 6 changed files with 43 additions and 22 deletions.
61 changes: 41 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,14 @@ So far FTVLaunchX has been tested on:

- Fire TV Stick 2nd Generation (Fire OS 5.2.7.2)
- Fire TV Stick 4K (Fire OS 6.2.6.8)
- Nvidia Shield 2017 (Shield Android TV 8.0.1)

Please let me know if you are using it successfully on any other devices.

You can find me at the
[official discussion thread](https://forum.xda-developers.com/fire-tv/general/ftvlaunchx-custom-launcher-root-t4037397)
on XDA.

### Features

- Reliably intercepts any & all presses of the home button.
Expand Down Expand Up @@ -80,6 +85,15 @@ Documentation

### Setup

#### Downloads

All releases of FTVLaunchX can be downloaded as installable APKs from the
[release page][GITHUB_RELEASES].

If you are using [Aptoide TV](https://tv.aptoide.com/) on your Fire TV
device you can also download it directly from
[there](https://launchx.en.aptoide.com/).

#### Quick Installation Overview

FTVLaunchX needs the `WRITE_SECURE_SETTINGS` permission to enable an
Expand Down Expand Up @@ -123,15 +137,15 @@ from a mobile phone running Android or a desktop PC.
device when asked (see 6. in Pre-Requisites above)
7. When presented with a command-line within the `Remote ADB Shell`
application, enter and run the following command:
```
pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS
```
```
pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS
```
8. Open FTVLaunchX, select a launcher and press the home button – enjoy!

##### Method 2: via ADB from an Android phone

1. Use a browser to download the latest release of FTVLaunchX from the
[release page][GITHUB_ISSUES] to your phone
[release page][GITHUB_RELEASES] to your phone
2. Install the [Easy Fire Tools](https://play.google.com/store/apps/details?id=de.agondev.easyfiretools)
application from Google Play on your phone
3. Install the [Remote ADB Shell](https://play.google.com/store/apps/details?id=com.cgutman.androidremotedebugger)
Expand All @@ -141,16 +155,16 @@ pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS
5. Open `Remote ADB Shell`, connect to your Fire TV by using the IP address
of your device (see 6. in Pre-Requisites above) and run the following
command:
```
pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS
```
```
pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS
```
6. Open FTVLaunchX on your Fire TV device, select a launcher and press the
home button – enjoy!

##### Method 3: via ADB from a desktop PC or laptop

1. Use a browser to download the latest release of FTVLaunchX from the
[release page][GITHUB_ISSUES] to your computer
[release page][GITHUB_RELEASES] to your computer
2. Install `ADB` and connect to your Fire TV by using the IP address
of your device (see 6. in Pre-Requisites above), see
[here](https://developer.amazon.com/docs/fire-tv/connecting-adb-to-device.html)
Expand All @@ -159,18 +173,18 @@ pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS
following commands (make sure to use the actual name of the downloaded
file):
- For devices running Fire OS 5 (Fire TV Stick 2nd Generation)
```
adb install FTVLaunchX-x.y.z.apk
```
```
adb install FTVLaunchX-x.y.z.apk
```
- For devices running Fire OS 6 or 7 (Fire TV Stick 4K & Fire TV Cube)
```
adb install -g FTVLaunchX-x.y.z.apk
```
4. If your device is not running Fire OS 6 or 7 then grant the required
permission by running, otherwise proceed to step 5:
```
adb pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS
```
```
adb install -g FTVLaunchX-x.y.z.apk
```
4. If your device is not running Fire OS 6 or 7 then grant the required
permission by running, otherwise proceed to step 5:
```
adb pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS
```
5. Open FTVLaunchX on your Fire TV device, select a launcher and press the
home button – enjoy!

Expand All @@ -179,7 +193,11 @@ add the `-r` flag to the `adb install` commands in step 3.

### Usage

Just start FTVLaunchX and select the application to use as your launcher.
Just start FTVLaunchX and select the application to use as your launcher:

<p align="center">
<img src="./gfx/Screenshot.jpg" width="640" height="360" />
</p>

From now on, every time you boot your device, wake it up from sleep or press
the home button, you will be taken to this application.
Expand All @@ -194,6 +212,9 @@ buttons at the same time.

You can also get to the default Amazon home screen by using this method.

And, of course, you can also still use Alexa to get to the settings menu or
the original Amazon home screen: just say "Home" or "Settings".

Lean back & enjoy!


Expand Down
2 changes: 1 addition & 1 deletion app/build.gradle
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ apply plugin: 'com.android.application'

def versionMajor = 1
def versionMinor = 0
def versionPatch = 0
def versionPatch = 1
def versionSuffix = ""

def keystorePropertiesFile = rootProject.file('keystore.properties')
Expand Down
2 changes: 1 addition & 1 deletion app/src/main/AndroidManifest.xml
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@
<receiver
android:name=".HomeReceiver"
android:permission="android.permission.RECEIVE_BOOT_COMPLETED">
<intent-filter>
<intent-filter android:priority="999">
<action android:name="android.intent.action.BOOT_COMPLETED" />
</intent-filter>
</receiver>
Expand Down
Binary file added gfx/Banner-Large.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gfx/Icon-Large.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gfx/Screenshot.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 3b103b9

Please sign in to comment.