fgl27 / SmartTwitchTV

**SmartTV Twitch AndroidTV APK** • About the project • About this fork • How the application works • The web app • The APK • The interactions between web app and APK • How the application looks • How to translate this • How to translate and test? • Translate • Testing app/languages/en_US.js • Testing apk/app/src/main/res/values/strings.xml • How to send the files • Download • Dependencies • Web Dependencies • APK Dependencies • Are phones and tablets supported? • Authorization • when accessing Twitch authorization site after adding yours credential User and password you will see the below information • How to build, languages and etc related • Code Languages used by the project • How to Build • Building The web app • Javascript building The web app • HTML building The web app • CSS building The web app • Build The APK • How to test the Web app • In an browser • Inside the APK • Contributing instructions • How to make changes and test it • Changelog • TODO list • Donations • PayPal • BitCoin • Pix • In doubt open a issue About the project This is a web application designed to give access to Twitch features on SmartTV's, the official Twitch app is not available for most devices, that is why this project exists. The intention of this is to make a web app that works on all modern browsers and can be easily ported to any OS that can run a web app. This app has no affiliation with Twitch, this is a user made app, but is only possible because Twitch provides all the APIs that allow the app to show Twitch content. Those APIs are documented here: Twitch Developer Documentation This app has to be registered to access Twitch API, that registration process is described here: Twitch Registration process This project is the main project of two Twitch projects I current maintain, originally I started working on the smarttv-twitch repo, I'm using separate repos to make it easier to use GitHub pages and keep commit history separated. The original project runs on Samsung Tizen OS, which is very limited. Because of that, the Android version has become the main project, not all features of the Android project can be ported to the Samsung one, but from time to time I will port the features from the Android version to the Samsung version. About this fork I initially forked this from https://github.com/CazuzaCzz/SmartTwitchTV/commits/tizen The original fork is https://github.com/nikitakatchik/SmartTwitchTV I have started this project because the above repos of the app did not fully support my TV model (at the time this was a Samsung Tizen OS only project) and didn't have all possible Twitch features. I keep the original name and commit history but not as a fork simply because I made so many changes and it makes no sense to call this a fork. I have made a new application from scratch focusing on performance and all available Twitch features, with the help of users and contributors reporting bugs and asking for features the app has become what is today, an app that can be easily used to watch all available Twitch content and give the user lots of extra options, but I know that the application can be improved with new features and improvements are always in the works, mostly to provide better experience and more options to the user, but that process is slow mostly because there is only one person working on the project and that work is done for free on spare time. How the application works The application is split into two parts: a web app and an Android APK. The web app The web app is a web page Click here to access it, this page contains the app user interface and most of the app logic. The APK The APK holds two main views of the app: • the Webview the view that loads - the web app page • the PlayerActivity - the main app activity and the activity that holds the app players and web UI The APK also handles the Android specific interactions that the app needs to make all to work. The interactions between web app and APK The web app and the APK use a "OS interface" to communicate back and forth. The web app interacts with the APK by using one of the functions in SmartTwitchTV/app/specific/OSInterface.js. Each of those functions has a "mirror function" on the Java side of the code, the Java side of those functions is annotated with **JavascriptInterface** in PlayerActivity. That **JavascriptInterface** uses the class named **public class WebAppInterface** to hold all the functions. To communicate with the web app, the APK will use this function call where that must be one of the functions exposed by app API In order for the app to work, the back and forth communication between the UI and the APK is necessary. The process is technically simple but if you've never seen it, it may seem complicated at first. How the application looks The application never stops receiving updates. The below video may be outdated, I try to keep an updated video always available but is not a priority How to translate this The app has two strings files: • app/languages/en_US.js • apk/app/src/main/res/values/strings.xml Follow the below instruction to translate, test and send the files back. How to translate and test? • Download and extract the app source • Navigate and open app/languages/en_US.js and follow the below Translate and Testing steps • Do the same for apk/app/src/main/res/values/strings.xml Translate • Translate all string to the language you're adding • Delete from the file any string that when translated has no difference to the original EN_US String • Remove from the file any string that wasn't translated and add it to a separate file named for and for ; make sure you inform why you didn't translate in case there's an issue that needs to be resolved. • The files must be named this way so in the future it's easier to know which strings need to be updated, as when changes are made to the original strings I may remove them from the translation so the translator knows that they need to update, als…