meta data for this page
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
- 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.
- 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.