====== 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 ===== - **[[custom_rom:microg_setup|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. - **[[custom_rom:lineage_microg|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.