bttv-android
A mod of the Twitch Android Mobile App adding BetterTTV, FrankerFaceZ and 7TV emotes
This project is not affiliated to Twitch Interactive Inc, NightBot LLC, Dan Salvato LLC or the SevenTV project! THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND!
We need you
You can help this project by contributing translations on crowdin.
Features
- BTTV, FFZ and 7TV Emotes
- Auto-Claim Bonus Channel Points
- Auto Updater
- Sleep Timer
- Highlight Keywords
- Split Chat
Known issues
- Amazon Video Watch Parties require the Twitch App to be installed on the device and the optional step in the install instructions below
- Animated Emotes occasionally glitch on some devices
Install
- Skim through this guide on how to enable third party app istallations
- Go to the latest release page and download the
.apkfile of the mod. It periodically checks for new releases so you only have to download it once from there.
- (Optional) Prevent Twitch from opening when you interact with twitch.tv links: Long-press on the Twitch App -> "App Info" -> "Advanced" -> "Open by default" -> "Open supported links" -> "Ask every time" (might vary depending on OEM)
Build it yourself
This patch is meant to be applied to version 12.1.2 of the official twitch app Make sure you use this version before you create an issue!
Easy way: Docker
Prerequisites:
Docker
How to:
-
Clone this repo
-
Get the Twitch App's apk files (e.g from here, or here)
Please make sure you get it from a non-shady source!
If you have downloaded a single
.apkfile, name ittwitch.apkIf you have downloaded a bundle of
.apkfiles put them in a.ziparchive and name ittwitch.zipNote: Apkmirror publishes bundles as
.apkmfiles, those are justzipfiles, so rename them totwitch.zip -
Run the builder:
docker run --rm -ti \ -v path/to/twitch.apk:/usr/build/twitch.apk \ -v /path/to/dist:/usr/build/dist \ -v path/to/patches:/usr/build/patches \ -v /path/to/mod:/usr/build/mod \ -v /path/to/.all-contributorsrc:/usr/build/.all-contributorsrc \ ghcr.io/bttv-android/builderIf you are in the same directory as the apk file you can copy and paste:
docker run --rm -ti \ -v $(pwd)/twitch.apk:/usr/build/twitch.apk \ -v $(pwd)/.bttv-cache:/usr/build/.bttv-cache \ -v $(pwd)/dist:/usr/build/dist \ -v $(pwd)/patches:/usr/build/patches \ -v $(pwd)/mod:/usr/build/mod \ -v $(pwd)/.all-contributorsrc:/usr/build/.all-contributorsrc \ ghcr.io/bttv-android/builder -
The
distdirectory will contain the patched apk file! -
Transfer to device and install apk
-
Remove the builder again:
docker rmi ghcr.io/bttv-android/builder
Hard way
Prerequisites:
| Tool | Env variable | Default |
|---|---|---|
| Bash | Has to be in /bin | |
| Git | Has to be in PATH | |
| Java JDK | JAVA_PATH and JAVAC_PATH | java and javac (from PATH) |
| Android SDK or install using Android Studio | BUILDTOOLS_PATH | ~/Android/Sdk |
| ApkTool | APKTOOL_PATH | /opt/apktool/apktool.jar |
| Uber APK Signer | UBER_APK_SIGNER_PATH | /opt/uber-apk-signer/uber-apk-signer-1.2.1.jar |
| Baksmali | BAKSMALI_PATH | /opt/baksmali/baksmali-2.4.0.jar |
| build-companion | BUILD_COMPANION | /opt/build-companion |
How to:
If you get stuck at any point, just remove the
disassdir and try again
- Download and install prerequisites
- Get the Twitch App's apk files (e.g from here), drop them zipped in this directory and call it "twitch.zip"
Please make sure you get it from a non-shady source! If you have adb installed follow this guide (Method 3)
- The
./initworkspacescript will disassemble the apks, build the sources, apply monkey patches and build the new apk for you - Transfer to device and install apk
(Adb installed and device connected? Try the :
./installscript)
This repo is mirrored on Gitlab.
Made with
Contributors
β¨
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!
31 Dec 12, 2022
1 Mar 2, 2022
4 Jan 2, 2023
6 Sep 3, 2022
4 Dec 20, 2022
24 Dec 25, 2022
3 Oct 21, 2022
237 Dec 9, 2022
2.7k Jan 1, 2023
151 Dec 30, 2022
23 Dec 2, 2022
9 Feb 6, 2022
41 Nov 28, 2022
2 Jul 3, 2022
9 Dec 27, 2022
2 Jan 14, 2022
1 Oct 1, 2022
8 Aug 12, 2022
42 Dec 11, 2022