====== 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.