-brightgreen.svg){kind=icon}
BatteryRemapper is a modern Xposed/LSPosed module paired with an intuitive Material management application. It recalibrates Android's battery reporting scale, mapping a customizable physical battery window (by default 20% – 80%) into a full 0% – 100% display layer across your status bar, quick settings, and lock screen.
By restricting daily operational usage to these optimal chemical thresholds, BatteryRemapper significantly minimizes lithium-ion degradation, prevents high-voltage stress, and dramatically extends the lifespan of your device's non-removable battery.
- Interactive Material Manager: Clean, responsive UI with full Material 3 dynamic styling, system bar edge-to-edge support, and automatic dark/light theme integration.
- Customizable Physical Range: Adjust your physical charge ceiling and floor using an interactive dual-thumb range slider (e.g., 20% – 80%, 15% – 85%, or any custom bounds).
- Live Hook Detection: Real-time bidirectional IPC handshake that probes System UI to immediately indicate whether the module hook is Active, Inactive, or Checking.
- Linear Scale Remapping: Smoothly translates physical battery percentage to your configured scale across the status bar, notification shade, and lock screen.
- Smart Hysteresis Battery Saver Automation:
- Triggers ON: Automatically enables Battery Saver mode when your remapped percentage reaches 20% or below.
- Triggers OFF: Automatically turns Battery Saver mode OFF once remapped battery charges past 50%.
- Hysteresis Dead-Zone: Maintains existing state between 21% – 50% when unplugged to prevent battery state flickering.
- Charging Bypass: Instantly disengages Battery Saver upon connecting a charger (AC, USB, or Wireless) for maximum charging performance.
- Toggle Control: Can be enabled or disabled on demand from the app.
- Automated Low-Battery Shutdown Protection:
- Optional safety sequence that initiates a system-level 30-second countdown when reaching your chosen trigger level (defaulting to 0% remapped).
- Smart Charger Abort: Plugging in a charger instantly aborts the shutdown sequence and dismisses the alert.
- Dismissal Safeguard: Dismissing the alert dialog temporarily suppresses repeated countdowns for the remainder of the discharge cycle.
- One-Click System UI Restart: Dedicated root-enabled action (
su -c killall com.android.systemui) with confirmation dialog to instantly apply changes without a full device reboot. - Seamless Shared IPC (
SettingsProvider): Rootless, real-time configuration sharing between the manager app and the System UI hook via an internal Content Provider. - About & Credits Hub: Dedicated About screen with dynamic version tracking, repository links, license details, and developer/contributor credits.
To ensure the module functions correctly, configure its target scope inside the LSPosed Manager (or compatible Xposed framework interface).
- System UI (
com.android.systemui)
Important
The module is specifically scoped to run inside com.android.systemui. This ensures your status bar, quick setting tiles, and lock screen graphics reflect your custom 0–100% scale while the underlying Android system server and kernel continue to track raw physical metrics accurately.
The display percentage is dynamically calculated from the physical percentage using linear normalization:
| Actual Physical Battery | Displayed Status Bar Battery | System Behavior & States |
|---|---|---|
| 80% and above | 100% |
Upper charge ceiling cap |
| 65% | 75% |
Intermediate remapped value |
| 51% | 51% |
Battery Saver turns OFF if unplugged |
| 35% | 25% |
Normal operational range |
| 25% | 8% |
Low battery threshold — Battery Saver is ON |
| 20% and below | 0% |
Lower charge floor — triggers shutdown countdown (if enabled) |
- Stepped Percentage Drops: Due to mathematical scaling of a compressed physical range (e.g., 60 points mapped to 100 points), the status bar percentage will occasionally step by 2% (e.g., jumping from 77% to 75%). This is natural linear rounding behavior.
- Direct Kernel Node Reads: Hardware monitor applications or terminal commands that bypass the Android framework to read raw kernel nodes directly (e.g.,
/sys/class/power_supply/battery/capacity) will reflect the raw physical percentage.
- Android Version: Android 10+ (API 29+).
- Root & Framework: Magisk or KernelSU/Apatch with Zygisk, and LSPosed (or compatible modern Xposed framework).
- Root Permission (Optional): Required only for the in-app "Restart System UI" quick action; the remapping and automation hooks themselves operate root-free inside System UI.
- ROM Compatibility:
- AOSP & Custom ROMs: Pixel, LineageOS, crDroid, Evolution X, Infinity X, Axion AOSP, Motorola, Sony, etc.
- OEM Skins: Xiaomi HyperOS / MIUI, Samsung One UI, OnePlus/OPPO/Realme OxygenOS & ColorOS, Vivo/iQOO OriginOS & FuntouchOS.
- Supports status bar customizations including circles, dotted icons, landscape pills, and text-only battery styles.
You can get the latest pre-compiled release from either source:
- 📦 GitHub Releases: Download Latest APK
- 🧩 LSPosed Module Repository: BatteryRemapper Module Page
- Telegram Discussion Group: BatteryRemapper Chat
- Developer Telegram: @dhangofa
- GitHub Issues: BatteryRemapper Issues
This project is open-source under the terms of the MIT License.