microg-installer/README.md
2025-11-21 11:02:13 +01:00

126 lines
4.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

[![Telegram](https://img.shields.io/badge/Telegram-microGRevivedAgain-blue?logo=telegram)](https://t.me/microGRevivedAgain)
[![Website](https://img.shields.io/badge/Website-spacealtctrl.net-blue?logo=firefoxbrowser&logoColor=white)](https://spacealtctrl.net)
# microG Installer Revived… again
A **Magisk / KernelSU module** that converts your installed microG GmsCore from a user app into a **system-level app** to improve **Play Integrity behavior** and testing on custom or rooted devices.
**Forked from nift4's microG Installer Revived** — updated to support **microG 0.3.10.250932**.
> **Note:** This module does not bundle or install microG. It promotes your already-installed microG to the system layer with proper privileges. Think of it as a **converter**, not a traditional installer.
---
## ⚠ Personal Project Notice
This is a personal side project maintained for testing and research. Current support focuses on **microG 0.3.10.250932**.
If you want to participate in testing or share results, join the Telegram testing group:
[https://t.me/microGRevivedAgainResults](https://t.me/microGRevivedAgainResults)
---
## Overview
This module allows your **user-installed microG apps** to operate at the system level by promoting them into `/system/priv-app/` using Magisk/KernelSU overlay mechanisms. By doing so, microG:
- Gains system-level privileges required for testing Play Integrity
- Is treated by Android as a system component without modifying `/system` permanently
- Allows apps to interact with microG in a closer-to-native environment
- Leaves your original user-installed apps untouched; the system prioritizes the overlayed copies
This approach provides a safe, reversible way to **evaluate Play Integrity responses** and improve compatibility in rooted or custom ROM environments.
---
## Features
- Detects installed microG GmsCore and Companion apps
- Converts them into **system-level apps** using overlay mechanisms
- Grants necessary **system permissions** and enables features like **signature spoofing**
- Reversible: removing the module restores the system to its original state
- Tested with latest microG releases while remaining compatible with prior 0.3.5+ versions (untested)
---
## Supported Versions
| Component | Version Tested |
|--------------------|--------------------|
| microG GmsCore | 0.3.10.250932 |
| microG Companion | 0.3.10.840226 |
| Older microG | 0.3.5+ (untested) |
---
## Requirements
**Do NOT install** if Google Play Services are present.
1. **Signature spoofing support** check using the Signature Spoofing Checker
- If unsupported, see [FakeGApps](https://github.com/whew-inc/FakeGApps/releases)
2. **Pre-installed microG apps** both GmsCore and Companion must be installed as **user apps** before flashing the module
---
## Installation
1. Verify signature spoofing is enabled
2. Install **microG GmsCore 0.3.10.250932** as a user app
3. Install **microG Companion / Play Store variant** as a user app
4. Flash this module via Magisk or KernelSU
5. Reboot
6. Grant necessary permissions in microG Settings
> The module automatically detects and converts your user-installed apps to system-level versions during boot.
---
## Updating microG
For updates **within the 0.3.10.x series**, simply install the new APK — no need to reflash the module.
Sources:
- [microG GitHub Releases](https://github.com/microg/GmsCore/releases)
- [microG F-Droid Repository](https://microg.org/download.html)
---
## Notes for Play Store Users
- Install the Play Store APK (standard APK, not bundle) **before flashing**
- Module should detect and convert it automatically
- Contact the maintainer if detection fails
---
## Testing & Feedback
This module is intended for **testing and improving Play Integrity results**. Testers are encouraged to report:
- System-level behavior of apps interacting with microG
- Boot and overlay behavior on different ROMs and kernels
- Any permission, integration, or compatibility anomalies
**Recommendation:** use secondary devices or emulators and back up important data before testing.
---
## Credits
- **microG Project** microG GmsCore and Companion
- **nift4** original microG Installer Revived
- **Hieu Van** original microG Installer
- **Contributors** Fs00, chris42, FriendlyNeighborhoodShane, and others
---
## Links
- [Report Issues](https://github.com/spacealtctrl/microg_installer_revived_again/issues)
- [Original Project](https://github.com/nift4/microg_installer_revived)
- [microG Project](https://microg.org)
- **Telegram Testing Group:** [https://t.me/microGRevivedAgainResults](https://t.me/microGRevivedAgainResults)