Table of Contents

Custom ROMs & microG: Overview & Compatibility

SUPPORT & SCOPE NOTICE

  • Unofficial Community Resource: Total Launcher is developed for standard Android environments with Google Play Services. ChYK (Total_Apps) does not provide technical support for custom ROMs, unlocked bootloaders, or microG.
  • Community Help: For setup questions or troubleshooting on modified devices, visit the Total Launcher - a uiTLM community Discord server or r/uiTotalLauncher.

Why Run Total Launcher on a Custom ROM?

Many privacy-focused and power-user Android distributions—such as LineageOS, crDroid, CalyxOS, and /e/OS—omit proprietary Google apps and background telemetry by default. Because Total Launcher is lightweight, self-contained, and deeply scriptable with Tasker and MacroDroid, it pairs naturally with de-Googled devices.


Package & Licensing Compatibility

Total Launcher uses a two-app architecture:

Package Package ID Works Without Google / microG? Notes
Total Launcher com.ss.launcher2 Yes All core free features operate offline with zero Google dependencies.
Total Launcher Key com.ss.launcher2.key Requires License Check Unlocks Pro features. Requires an active license verification framework (such as Google Play or properly configured microG with an official license).

Official Distribution Policy: uiTLM only documents and supports official distribution channels for Total Launcher and Total Launcher Key. We do not host APKs or recommend third-party Play Store scrapers.


Choose The Setup Path

  1. Installing microG on an Existing Custom ROM — Follow this guide if the device is *already* running a custom ROM with Signature Spoofing support (such as official LineageOS 21+) and the need to add microG via F-Droid exists.
  2. Using LineageOS for microG — Follow this guide if starting fresh on a supported device and wanting a single-flash ROM that already includes microG and F-Droid pre-installed.