Debloat any Android or Google TV over Wi-Fi and get an Apple TV-style home.
Python adbadblockandroid-tvandroid-tv-launcherapple-tvbloatware-removalclaude-codedebloatfire-tvgoogle-tvlauncherprivacysmart-tvsony-braviatclvibe-codingxiaomi
Workflow: Add or fix a launcher translation
When to use this: a new launcher language, or strings missing from existing ones.
- Create
launcher/app/src/main/res/values-<qualifier>/strings.xmland translate every string inlauncher/app/src/main/res/values/strings.xml, skipping the ones markedtranslatable="false". Keep placeholders (%1$s,%d) and XML escapes intact. The folder suffix is the qualifier Android reads:defor a language,zh-rCNfor a language with a region, or the BCP-47 form the tree also uses,b+sr+Latn, for a language with a script (values-sr-Latnis not a folder it reads). - A language may also need one of the other files
values/carries. Add it only whenvalues/has the same file, and only the names that file defines:tests/test_translation_recipe_files.pyholds both.bools.xml:date_single_linefalse when the language's weekday and month names do not fit on one line (values-de,values-es,values-b+es+419,values-ast,values-pt,values-ruandvalues-ukset it), andrtl_app_grid/rtl_menu_bartrue for a right-to-left language (values-iw).fonts.xml: pointfont_body,font_regularand the otherfont_*at the system families when the bundled Outfit has no glyphs for the language's letters (values-vi, #833).lunar.xml: the lunar date format, the leap-month wording and the stem and branch names, for a language that names them itself (values-zh-rCN,values-zh-rTW,values-vi,values-ko). Keeplunar_stemsat ten items andlunar_branchesat twelve:Lunar.javaindexes both by position, so a short list crashes the launcher on a TV running that language and nothing anywhere else.
- Add the locale to
launcher/app/src/main/res/xml/locales_config.xml, in the tag form: a language folder that is not registered there cannot be chosen for the launcher alone on Android 13+. - Add the language to the Languages list in
docs/launcher.md, in the name that list uses, and the same name to theNAMEStable intests/test_locales_registered.py. That table is the only map from the qualifier Android reads (sr-Latn) to the English name the page uses ("Serbian (Latin)"), sotest_the_name_table_covers_every_folderstays red until both are there: "a language has no English name in this test's table". Step 3'slocales_config.xmlentry does not satisfy it. - To fix a missing string in existing locales, add it to every
values-*folder you can, in the same order as the defaultstrings.xml. A missing string falls back to English (launcher/app/lint.xml), but a new switch needs its strings in every locale. - Moving hard-coded text into resources is welcome; do not bundle unrelated build changes with it.
- Check the size gate before you push. A language's strings ship in the release APK, and that APK has to
stay under 589,824 B (576 KB):
launcher/app/build/outputs/apk/release/app-release.apk, measured withstat -c %son Linux orstat -f %zon macOS, and checked by the "Launcher build and unit tests" job on every pull request.README.mdquotes the launcher at about 572 KB, so a full language can be the difference between green and a failed build. A language that does not fit is a maintainer decision, not something to land by dropping strings (#1271). - Build the launcher, set the TV's language (Android 13+:
tools/tv.py 'cmd locale set-app-locales com.gathin.tvhome --locales <tag>') and attach a screenshot. Right-to-left languages mirror the layout like Hebrew;tests/test_hebrew_resources.pychecks thatlayout-iwkeeps every view. - The language count moves with the folder. Five front pages state it in the card's alt text and in the
| **N languages** |row -README.md,README.nl.md,README.de.md,README.uk.mdandREADME.tr.md- andtools/readme_stats.py'sSTATScarries it for the pictures, so a language added without them leaves those pages and the card claiming the old number. Two more state it in that row alone, in digits:README.he.mdandREADME.pt-BR.md. Neither carries the generated brand block or the card, sotools/gen_tables.pydoes not write either page at all, and nothing else read them: a language added without moving those two rows left the Hebrew and Portuguese front pages offering one fewer language than the launcher ships, with the suite green.tests/test_readme_language_count.pyreads the row on all seven.tests/test_gen_tables_translated_counts.pyfails on the translated page in the meantime ('355 tv-modellen · 97 merken · 30 talen · ' != '… 29 talen · '). Runpython3 tools/gen_tables.pyafter adding the folder: it moves the number in the pages it writes and inSTATS, prints thatdocs/stats.pnganddocs/card.jpghave to be redrawn with the font (--font Fredoka.ttf), and its--check- what CI's "README tables" job runs - exits 1 until they agree.
Then run the tests: python3 -m unittest discover -s tests -v.