Skip to content

Commit 3b103b9

Browse files
committed
Merge branch 'release/1.0.1'.
* 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'.
2 parents 6154b10 + 38c60c1 commit 3b103b9

File tree

6 files changed

+43
-22
lines changed

6 files changed

+43
-22
lines changed

README.md

Lines changed: 41 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,14 @@ So far FTVLaunchX has been tested on:
1919

2020
- Fire TV Stick 2nd Generation (Fire OS 5.2.7.2)
2121
- Fire TV Stick 4K (Fire OS 6.2.6.8)
22+
- Nvidia Shield 2017 (Shield Android TV 8.0.1)
2223

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

26+
You can find me at the
27+
[official discussion thread](https://forum.xda-developers.com/fire-tv/general/ftvlaunchx-custom-launcher-root-t4037397)
28+
on XDA.
29+
2530
### Features
2631

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

8186
### Setup
8287

88+
#### Downloads
89+
90+
All releases of FTVLaunchX can be downloaded as installable APKs from the
91+
[release page][GITHUB_RELEASES].
92+
93+
If you are using [Aptoide TV](https://tv.aptoide.com/) on your Fire TV
94+
device you can also download it directly from
95+
[there](https://launchx.en.aptoide.com/).
96+
8397
#### Quick Installation Overview
8498

8599
FTVLaunchX needs the `WRITE_SECURE_SETTINGS` permission to enable an
@@ -123,15 +137,15 @@ from a mobile phone running Android or a desktop PC.
123137
device when asked (see 6. in Pre-Requisites above)
124138
7. When presented with a command-line within the `Remote ADB Shell`
125139
application, enter and run the following command:
126-
```
127-
pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS
128-
```
140+
```
141+
pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS
142+
```
129143
8. Open FTVLaunchX, select a launcher and press the home button – enjoy!
130144
131145
##### Method 2: via ADB from an Android phone
132146
133147
1. Use a browser to download the latest release of FTVLaunchX from the
134-
[release page][GITHUB_ISSUES] to your phone
148+
[release page][GITHUB_RELEASES] to your phone
135149
2. Install the [Easy Fire Tools](https://play.google.com/store/apps/details?id=de.agondev.easyfiretools)
136150
application from Google Play on your phone
137151
3. Install the [Remote ADB Shell](https://play.google.com/store/apps/details?id=com.cgutman.androidremotedebugger)
@@ -141,16 +155,16 @@ pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS
141155
5. Open `Remote ADB Shell`, connect to your Fire TV by using the IP address
142156
of your device (see 6. in Pre-Requisites above) and run the following
143157
command:
144-
```
145-
pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS
146-
```
158+
```
159+
pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS
160+
```
147161
6. Open FTVLaunchX on your Fire TV device, select a launcher and press the
148162
home button – enjoy!
149163
150164
##### Method 3: via ADB from a desktop PC or laptop
151165
152166
1. Use a browser to download the latest release of FTVLaunchX from the
153-
[release page][GITHUB_ISSUES] to your computer
167+
[release page][GITHUB_RELEASES] to your computer
154168
2. Install `ADB` and connect to your Fire TV by using the IP address
155169
of your device (see 6. in Pre-Requisites above), see
156170
[here](https://developer.amazon.com/docs/fire-tv/connecting-adb-to-device.html)
@@ -159,18 +173,18 @@ pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS
159173
following commands (make sure to use the actual name of the downloaded
160174
file):
161175
- For devices running Fire OS 5 (Fire TV Stick 2nd Generation)
162-
```
163-
adb install FTVLaunchX-x.y.z.apk
164-
```
176+
```
177+
adb install FTVLaunchX-x.y.z.apk
178+
```
165179
- For devices running Fire OS 6 or 7 (Fire TV Stick 4K & Fire TV Cube)
166-
```
167-
adb install -g FTVLaunchX-x.y.z.apk
168-
```
169-
4. If your device is not running Fire OS 6 or 7 then grant the required
170-
permission by running, otherwise proceed to step 5:
171-
```
172-
adb pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS
173-
```
180+
```
181+
adb install -g FTVLaunchX-x.y.z.apk
182+
```
183+
4. If your device is not running Fire OS 6 or 7 then grant the required
184+
permission by running, otherwise proceed to step 5:
185+
```
186+
adb pm grant de.codefaktor.ftvlaunchx android.permission.WRITE_SECURE_SETTINGS
187+
```
174188
5. Open FTVLaunchX on your Fire TV device, select a launcher and press the
175189
home button – enjoy!
176190
@@ -179,7 +193,11 @@ add the `-r` flag to the `adb install` commands in step 3.
179193
180194
### Usage
181195
182-
Just start FTVLaunchX and select the application to use as your launcher.
196+
Just start FTVLaunchX and select the application to use as your launcher:
197+
198+
<p align="center">
199+
<img src="./gfx/Screenshot.jpg" width="640" height="360" />
200+
</p>
183201
184202
From now on, every time you boot your device, wake it up from sleep or press
185203
the home button, you will be taken to this application.
@@ -194,6 +212,9 @@ buttons at the same time.
194212
195213
You can also get to the default Amazon home screen by using this method.
196214
215+
And, of course, you can also still use Alexa to get to the settings menu or
216+
the original Amazon home screen: just say "Home" or "Settings".
217+
197218
Lean back & enjoy!
198219
199220

app/build.gradle

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ apply plugin: 'com.android.application'
44

55
def versionMajor = 1
66
def versionMinor = 0
7-
def versionPatch = 0
7+
def versionPatch = 1
88
def versionSuffix = ""
99

1010
def keystorePropertiesFile = rootProject.file('keystore.properties')

app/src/main/AndroidManifest.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@
4646
<receiver
4747
android:name=".HomeReceiver"
4848
android:permission="android.permission.RECEIVE_BOOT_COMPLETED">
49-
<intent-filter>
49+
<intent-filter android:priority="999">
5050
<action android:name="android.intent.action.BOOT_COMPLETED" />
5151
</intent-filter>
5252
</receiver>

gfx/Banner-Large.png

116 KB
Loading

gfx/Icon-Large.png

61.9 KB
Loading

gfx/Screenshot.jpg

68.1 KB
Loading

0 commit comments

Comments
 (0)