bttv-android
A mod of the Twitch Android Mobile1 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
- Anon 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
-
7TV’s zero width emotes are not supported right now
-
Personal Emotes are not supported for now
-
Users have reported that notifications are not working for them. To fix this go to «App-Info -> Open Supported Apps» and select «Only in this application».
-
bttv-android will not work on Android TVs as it is a mod of the Twitch mobile App and not of the Twitch Andorid TV App. You can install it, just do not expect a good experience
Install
- Skim through this guide on how to enable third party app istallations
- Go to the latest release page and download the
.apk
file 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 14.3.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
.apk
file, name ittwitch.apk
If you have downloaded a bundle of
.apk
files put them in a.zip
archive and name ittwitch.zip
Note: Apkmirror publishes bundles as
.apkm
files, those are justzip
files, 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 -v /path/to/bttv.manifest.json:/usr/build/bttv.manifest.json ghcr.io/bttv-android/builder
If 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 -v $(pwd)/bttv.manifest.json:/usr/build/bttv.manifest.json ghcr.io/bttv-android/builder
-
The
dist
directory 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) |
jq | Has to be in 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
disass
dir 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
./initworkspace
script 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 :
./install
script)
This repo is mirrored on Gitlab.
Made with ♥️ by @FoseFx and contributors. MIT License.
Contributors ✨
Thanks goes to these wonderful people (emoji key):
Max Baumann 🚧 | LEMIBANDDEXARI 🌍 🤔 🐛 | Stephan 🤔 🌍 | Corentin Detry 🐛 🌍 | Dione Batista 🌍 🐛 | Erős Dániel 🐛 | Xslash 🌍 |
Artur 🌍 | YOEL_44 🌍 | albertopasqualetto 🌍 | kendricktsoi 🌍 | ashamefuldog 🤔 | Zeuxis29 🌍 | xplod62 🤔 |
colahobi 🤔 | Christiano Rangel 🐛 🤔 | GauravM512 🤔 🐛 | Dennis Magee 🐛 | Senpai206 🐛 | ReggX 🤔 | ZerolCamb 🌍 |
Mete 🌍 | splizh 🌍 | Ikko Ashimine 📖 | KeepSOBP 🌍 | jhurag 🌍 | Avernys 🌍 | Jfamig 🤔 |
NumbPat 🐛 | Josh Roy 🤔 | Lather0519 🌍 | zezofelipe 🌍 🤔 | ARTH-V-R 🐛 | linkmath 🐛 | Oleg 🐛 |
3bood_k 🌍 | moonMan8 🤔 | mirronake 🌍 | Marius Andersen 🐛 | mklwong 🐛 | owwouwu 🐛 | Wissididom 🌍 |
SaintKappa 🌍 | sassvagyok 🌍 | Wacra 🤔 | Blueberryy 🌍 | Dlevda 🐛 | AFranzo 📖 |
This project follows the all-contributors specification. Contributions of any kind welcome!
Twitch — одна из самых популярных стриминговых платформ на рынке. У этого есть множество причин: от банальной привычки пользователей (Twitch «выстрелила» раньше конкурентов) до лаконичного интерфейса, широкого функционала и поддержки 29 языков, включая разновидности испанского и португальского. Занимать лидирующую позицию сервису не мешают даже местами абсурдные правила, различные ограничения и санкции.
Благодаря популярности Twitch обзавелась множеством авторов контента и пользователей, а вместе с ними и мемов. Часть из них известна широкой публике, а какие-то являются более локальными. Однако их все объединяет одна из главных фишек Twitch — смайлы. Разработчики уделяют им много внимания, но из-за авторских прав и жёсткой системы модерации контента не все эмоуты доступны на платформе официально. Если вместо смайликов в чате вы видите надписи KEKW, FeelsBadMan, monkaS, AYAYA, OMEGALUL, catJAM и другие, значит, у вас ещё не установлены нужные расширения. О том, какие существуют программы, что они предлагают и как ими пользоваться, — в материале Cybersport.ru.
Все смайлы на Twitch можно поделить на две разновидности (статичные и анимированные), а также на три категории: стандартные, авторские и сторонние. К стандартным относятся бесплатные эмоуты от разработчиков. На момент публикации материала таких смайликов 254, в их число входят Kappa, SMOrc, PoroSad и другие. Они доступны всем пользователям в категории «Весь мир». Периодически список пополняется, однако бывают случаи, когда эмодзи убирают.
Глобальные смайлики на Twitch
К авторским можно отнести смайлики, загружаемые стримерами. Возможность добавить набор есть у авторов, участвующих в партнерской программе Twitch. А использовать его смогут только подписчики канала.
Cмайлики для подписчиков канала DreadzTV на Twitch
Сторонние смайлики — те, что можно использовать только при установке дополнительных расширений вроде BetterTTV (BTTV), FrankerFaceZ (FFZ) и 7TV. Для корректной работы таких эмоутов стример должен подключить программу к своему каналу. Каждая из них содержит базовый набор смайликов, а также позволяет составить уникальный набор для своей аудитории. Для этого стример должен выбрать нужные эмоуты в каталогах расширений или загрузить их самостоятельно. Кроме того, у зрителей также должно быть установлено расширение, поддерживающее отображение этих смайликов, иначе вместо картинок в чате будет появляться только текст.
Смайлики для пользователей FFZ
Смайлики для пользователей BTTV
Смайлики для пользователей 7TV
Расширения FFZ, BTTV и 7TV — чем различаются и какое выбрать?
Три столпа сегмента сторонних смайликов — расширения FFZ, BTTV и 7TV. Каждое из них представляет собой отдельное приложение с уникальным интерфейсом, базой эмоутов, а также дополнительным функционалом. Однако зрителям не обязательно устанавливать все расширения, достаточно будет использовать только одно из них. Это обусловлено тем, что возможности каждого из них включают распознавание смайликов других сервисов. При этом пользоваться всеми расширениями одновременно тоже никто не запрещает.
FrankerFaceZ имеет свою базу смайликов, а также поддерживает наборы из BTTV и 7TV. Кроме того, сервис предлагает широкие возможности по настройке внешнего вида чата и полезные функции для работы с Twitch. Например, FFZ скрывает стримеров не в сети в списке отслеживания, подключает функцию компрессора к плееру для улучшения звука на трансляции и многое другое. При этом расширение доступно на русском языке.
У BetterTTV есть своя библиотека смайликов, а также поддержка эмоутов FFZ и веб-эмодзи. Минус расширения в том, что оно не отображает наборы из 7TV. Наиболее интересные дополнительные функции BTTV — возможность перенести чат на левую сторону от плеера, сменить шрифт и его размер, а также скрыть себя из списка зрителей или прочитать удаленные модераторами сообщения.
7TV поддерживает смайлики как BTTV, так и FFZ, а также имеет свой набор эмоутов. Кроме того, расширение позволяет использовать анимированные аватары на Twitch и отключать оповещения об отправке идентичных сообщений в чате.
Как установить и пользоваться смайликами FFZ, BTTV и 7TV на ПК
- Скачать расширение для браузера. Сделать это можно на официальных сайтах программ: FrankerFaceZ, BetterTTV и 7TV. Дальнейшие действия будут зависеть от выбранного сервиса.
В случае с FFZ:
- Нужно зайти на любую страницу на Twitch.
- Кликнуть на значок расширения, который находится слева от вашего аватара на верхней панели.
- В открывшемся окне необходимо перейти во вкладку «Дополнения».
- Включить расширения 7TV и BTTV.
- Зайти в разделы «Смайлы 7TV» и BetterTTV, где проставить отметки у необходимых вам функций.
Инструкция по установке FFZ на ПК
Инструкция по установке FFZ на ПК
Инструкция по установке FFZ на ПК
Для BetterTTV:
- Зайти на любую страницу на Twitch.
- Кликнуть на ваш аватар в правом верхнем углу.
- Во всплывающем меню нажать на раздел BetterTTV Settings.
- Во всплывающем окне пролистать до раздела Emotes Menu и перевести тумблер в активированное положение.
- Ниже будет раздел Emotes, где необходимо поставить галочки для каждого пункта.
Инструкция по установке BetterTTV на ПК
Инструкция по установке BetterTTV на ПК
Для 7TV:
- Кликнуть на значок расширения, который находится слева от вашего аватара на верхней панели.
- В открывшемся окне необходимо пролистать до пункта Hide the 7TV emote menu.
- Убрать галочку у функции, если она была включена.
Инструкция по установке 7TV на ПК
Инструкция по установке 7TV на ПК
Как установить и пользоваться смайликами FFZ, BTTV и 7TV на Android
Для того чтобы пользоваться дополнительными смайликами на смартфоне, придется установить стороннее приложение. Есть несколько наиболее популярных вариантов: Chatsen, DankChat, Frosty и TwitchMod. Последнего нет в магазине приложений Google Play и других, установить его можно через APK-файл. Необходимо помнить, что TwitchMod не прошел проверку на потенциальную опасность, а потому использовать его стоит на свой страх и риск.
В случае с Chatsen:
- Скачать приложение в Google Play.
- Запустить и авторизоваться по данным своего аккаунта на Twitch.
- В нижнем поле ввести название канала, который вы хотите смотреть.
- Открыть левое меню и нажать на значок Play.
Инструкция по установке Chatsen на Android
Инструкция по установке Chatsen на Android
Инструкция по установке Chatsen на Android
Инструкция по установке Chatsen на Android
Инструкция по установке Chatsen на Android
Инструкция по установке Chatsen на Android
Инструкция по установке Chatsen на Android
Инструкция по установке Chatsen на Android
Для Frosty:
- Скачать приложение в Google Play.
- Запустить приложение и нажать на шестеренку в правом верхнем углу.
- Открыть вкладку Account.
- Авторизоваться по данным своей учетной записи на Twitch.
- Выбрать любой канал из списка Following либо найти нужный, перейдя во вкладку Search в нижнем меню.
Инструкция по установке Frosty на Android
Инструкция по установке Frosty на Android
Инструкция по установке Frosty на Android
Инструкция по установке Frosty на Android
Инструкция по установке Frosty на Android
Инструкция по установке Frosty на Android
Инструкция по установке Frosty на Android
Для DankChat:
- Скачать приложение в Google Play.
- Запустить приложение и нажать на три точки в правом верхнем углу.
- Нажать на кнопку «Войти» и авторизоваться по данным своей учетной записи на Twitch.
- Нажать на иконку + и ввести название канала, который вы хотите смотреть.
- Открыть всплывающее окно нажатием на кнопку с указателем вниз и выбрать пункт «Отображать трансляцию».
Инструкция по установке DankChat на Android
Инструкция по установке DankChat на Android
Инструкция по установке DankChat на Android
Инструкция по установке DankChat на Android
Инструкция по установке DankChat на Android
Инструкция по установке DankChat на Android
Инструкция по установке DankChat на Android
Для TwitchMod:
- Скачать APK-файл с канала разработчика в Telegram и установить приложение.
- Авторизоваться по данным своего аккаунта на Twitch.
Как установить и пользоваться FFZ, 7TV и BetterTTV на iOS:
В случае с Chatsen:
- Скачать приложение в App Store.
- Авторизоваться по данным своего аккаунта на Twitch.
- В открывшемся окне необходимо перейти во вкладку «Дополнения».
- В нижнем поле ввести название канала, который вы хотите смотреть.
- Открыть левое меню и нажать на значок Play.
Для Frosty:
- Скачать приложение в App Store.
- Авторизоваться по данным своего аккаунта на Twitch.
- В открывшемся окне необходимо перейти во вкладку «Дополнения».
- В нижнем поле ввести название канала, который вы хотите смотреть.
- Открыть левое меню и нажать на значок Play.
!!! ATTENTION !!! ATTENTION !!! ATTENTION !!!
For download links and status updates on the mod you can now follow nopbreak’s official Telegram channel:
https://t.me/pubTw
Why Telegram and not just posting the apk on GitHub? I don’t know, guess it’s easier for the developer to notify everyone about updates that way. Or maybe it’s to avoid Twitch’s maldhammer, since this mod basically loses them money.
!!! ATTENTION !!! ATTENTION !!! ATTENTION !!!
…
Hey bajs, just wanted to share this amazing Twitch app mod (Android only) made by a fellow KKomrade «n0pbreak» from 4PDA.ru that adds BTTV/FFZ support with gif emotes (probably drains battery faster) and shows deleted messages as crossed out. It’s pretty fucking good and makes your Twitch chat experience the same as it is on PC, without resorting to lidl alternate apps. And it’s ad-free, too.
Since this mod changes the original Twitch app, you need to uninstall it before installing the mod!
Full list of current features:
-
No ads and no telemetry
-
Platform: arm
-
Removed libraries: MoatAnalytics, INFOnline, Crashlytics, ComScoreTracker, BranchAppOpenTracker, NielsenTracker, AmazonAds, Facebook, GoogleAds
As options in settings (Go to your profile -> Settings -> Mod settings):
-
BetterTTV and FrankerFaceZ emotes (including GIF)
-
Emote picker with new emotes
-
Display FFZ badges
-
Swap TwitchCore Player for ExoPlayer2
-
Timestamps
-
See deleted messages in the chat
-
Copy messages by tapping & holding them
-
GIF emote mode: Disabled, Enabled (Static), Enabled (Animated)
-
Autoclicker for Channel Points
-
Choose emote source size
-
Hide unwanted tabs at the bottom (i.e. Discover, eSports)
-
Set chat’s width in landscape mode
-
Swipe up/down on the player to change brightness (left side) or volume (right side)
-
Highlight mentions in red
-
Display any stream’s chat if you’re permanently banned from it MODS
-
Floating chat over video in landscape mode
-
Disable autoplay
-
Choose mini-player’s size
-
Filter messages according to chat users’ status (plebs/subs/mods/broadcaster)
-
Ignore subs, events and other special messages
-
Old UI for some parts of the app
No Russian hacking included.
Source code on GitHub:
https://github.com/nopbreak/TwitchMod
Original download link (must be logged on to use 4PDA link, otherwise you can use Telegram):
https://4pda.ru/forum/index.php?showtopic=320321&st=2100#entry96966462
Examples of how it looks:
Phone:
https://i.imgur.com/VWEH8m3.jpg ᴵ ᵂᴬˢ ᴴᴱᴿᴱ
https://i.imgur.com/VGUQFuO.png (outdated version)
https://i.imgur.com/ZQ5r4QB.png (outdated version)
Tablet:
https://i.imgur.com/jscPFpd.png (Mod Settings->Chat menu)
POSSIBLE BUGS
Twitch-related:
Authorization errors, black/green screen on streams, lags/desync, no emotes in VODs, no notifications about streams, missing selected tags in filters, «Offline» status in your profile, duplicate messages in chat, «reconnecting» message in chat.
Mod-related:
Missing BTTV/FFZ emotes in emote selection, laggy/flickering GIF emotes, freezing/laggy stream window in smol mode (ExoPlayer only), dropdown list in mod settings resets its value after selection.
…
Post updated on 17.09.2020.
Updated featurelist and added some personal thoughts in the header regarding a frequently asked question. forsenScoots