Sam Icon's

# ⚠️ DISCLAIMER – READ BEFORE INSTALLING

This project is an LSPosed module that requires root access and hooks deeply into the Android system framework and SystemUI.

⚠️ THIS MODULE MODIFIES CORE SYSTEM BEHAVIOR
Improper usage or incompatible ROMs can and will cause serious issues, including:

- Bootloops
- SystemUI crashes
- Soft-bricks
- Random reboots
- Severe system instability

Install only if you fully understand the risks.

---

## 🚫 Responsibility Disclaimer

- The developer is NOT responsible for any damage, data loss, or device malfunction.
- You install and use this module entirely at your own risk.
- If your device fails to boot or becomes unstable, you are responsible for recovery.

Do NOT install this module if you do not understand:
- Root access
- LSPosed framework behavior
- How to disable LSPosed modules
- How to recover from bootloops or crashes using Magisk / ADB

---

## 📱 ROM Support & Compatibility

### ✅ Supported
- AOSP-based ROMs only
- Clean or near-stock AOSP implementations

### ❌ NOT Supported
- OEM ROMs, including but not limited to:
- Samsung One UI
- MIUI / HyperOS
- ColorOS
- OxygenOS
- Realme UI
- Any heavily modified proprietary framework ROM

OEM ROMs contain deep system changes that frequently break LSPosed hooks and may cause immediate bootloops or crashes.

---

## 🧪 Tested Environment

This module has been tested and confirmed working on:

- Device: Google Pixel
- ROM: Pixel Stock (AOSP)
- Android Version: Android 16
- Security Patch: December Update
- Build Number: BP4A.251205.006

⚠️ Compatibility with other devices, ROMs, or Android versions is not guaranteed.

---

## 🛡️ Crash Protection Notice

This module includes a Crash Protection feature.

- Crash Protection attempts to detect repeated SystemUI crashes.
- If a specific toggle or feature causes 2–3 consecutive UI crashes, the module will try to automatically revert or disable that feature to prevent continuous bootloops or crash cycles.

⚠️ Important Limitations
- Crash Protection is a best-effort safeguard, not a guarantee.
- Android framework crashes can happen suddenly and without warning.
- In some cases, the system may crash before the protection mechanism can take effect.
- There is NO guarantee that Crash Protection will always work or save the device.

You should never rely solely on Crash Protection and must still know how to manually disable the module if needed.

---

## 🧩 Feature Stability Notice

- Not all features are guaranteed to work on every AOSP-based ROM.
- Feature behavior may vary depending on:
- Android version
- SystemUI implementation
- Security patch level
- ROM-specific framework changes

You are expected to test features yourself.

The developer will not provide support for issues caused by:
- Unsupported ROMs
- OEM frameworks
- Experimental or heavily modified systems

---

## 💖 Credits & Acknowledgements

Special thanks to the following open-source projects for inspiration and reference:

- PixelXpert
https://github.com/siavash79/PixelXpert

- GboardHook
https://github.com/chenyue404/GboardHook

Huge thanks to the developers and contributors for their valuable work in the Android modding community. 🙏

GitHub

GitHub - siavash79/PixelXpert: mixed Xposed+Magisk module for customization of Google Pixel rom of Android 12+

mixed Xposed+Magisk module for customization of Google Pixel rom of Android 12+ - siavash79/PixelXpert

195 views14:39