XtremeBS (Xtreme Battery Saver)

Maximize your Android device’s battery life with highly configurable power-saving tools.

XtremeBS is a Magisk/KernelSU module designed for rooted Android devices, offering aggressive battery optimization through dynamic, event-driven settings. It allows advanced users to fine-tune CPU cores, apps, WiFi, Doze mode, and more to extend battery life significantly—potentially up to 5x stock uptime. While powerful, it requires careful configuration to avoid lag, missed notifications, or device instability.

[!NOTE]
An Android app is in development to simplify configuration and enhance usability. The current web UI (v1.0.6+) will be replaced upon app release.

Features

• App Management: Kill, suspend, or reprioritize apps with allowlists and denylists for user and system apps.
• CPU Optimization: Set CPU cores to powersave mode or disable high-power cores automatically or manually.
• System Tweaks: Force Doze mode (light/deep), disable WiFi, enable low RAM mode, or manage Google Mobile Services (GMS) and process priorities.
• Event-Driven Control (v2): Apply settings based on triggers like boot, charging, screen_off, low_power, or custom events.
• User-Friendly Tools: Control via XBSctl commands, monitor with logs and status files, and configure via a web UI (v1.0.6+).
• Safety Features: Safe mode to recover from misconfigurations and sanity checks to prevent system crashes.

Supported Root Managers

• Magisk (Confirmed)
• KernelSU (Confirmed)
• APatch (Likely compatible; please report results on GitHub Issues)

Disclaimer

XtremeBS is an advanced tool that modifies system behavior and requires root access. Misconfiguration may cause lag, missed notifications, alarms, or SystemUI crashes. Use at your own risk. I is not responsible for damages or data loss. Always back up your config and test settings incrementally.

Tested primarily on a Pixel 5 running ProtonAOSP. Compatibility varies by device and ROM.

Installation

1. Download the Module:

   • Grab the latest release from GitHub Releases.
   • Alternatively, install via MMRL for easy updates:
     

2. Install:

   • Flash the module in your root manager (Magisk/KernelSU).
   • Reboot your device.

3. Configure:

   • A default config file is created at /data/local/tmp/XtremeBS/XtremeBS.conf.
   • Edit the config manually or use the web UI (http://127.0.0.1:8081, launched via action.sh in v1.0.6+).
   • After changes, reload the config with XBSctl reload or reboot.

Configuration

XtremeBS uses a configuration file (/data/local/tmp/XtremeBS/XtremeBS.conf) to control its behavior. It supports two formats:

• v1 (Legacy): Simple key=value pairs. Suitable for basic setups but less flexible.
• v2 (Recommended): Event-driven blocks (e.g., screen_off={...}) for dynamic control based on device states or custom triggers.

[!TIP]
Set version=2 in the config to enable v2 mode. The module automatically migrates v1 configs to v2 if detected.

v2 Configuration (Recommended)

v2 uses event blocks to apply settings for specific triggers:

• Hardcoded Events: boot, charging, screen_off, low_power, manual (triggered by device states or XBSctl).
• Custom Events: User-defined (e.g., my_event), triggered manually via XBSctl start my_event.

Each block contains settings like disable_cores or handle_apps. Example:

version=2
delay=3
log_file=/sdcard/XtremeBS.log
log_level=3

screen_off={
  disable_cores=cpu6 cpu7
  handle_apps=nice
  allowlist=/data/local/tmp/XtremeBS/apps.allow
}

low_power={
  disable_cores=cpu2 cpu3 cpu4 cpu5
  doze=light
  kill_wifi=true
}

my_event={
  handle_gms=nice
  low_ram=true
}

Rules:

• Each block starts with event_name={ and ends with } on separate lines.
• Use alphanumeric characters, underscores, or dashes for custom event names (no spaces, $, =, {, or }).
• Empty blocks (e.g., boot={ }) do nothing.
• Multiple events can stack (e.g., screen_off and low_power disabling different cores) these work in a Last on, First off method, plan accordingly.

v1 Configuration (Legacy)

v1 uses a single trigger to apply settings globally. Example:

version=1
trigger=auto
delay=3
keep_on_charge=true
handle_cores=auto
disable_cores=false
handle_apps=suspend
allowlist=/data/local/tmp/XtremeBS/apps.allow

[!NOTE]
v1 is backward compatible but will be deprecated in future releases. Consider switching to v2 for advanced features.

Config Options

Allowlist Example (apps.allow):

com.termux
com.google.android.inputmethod.latin
com.topjohnwu.magisk

Process File Example (proc.list):

netd 19
system_server 10

[!CAUTION]
Always include essential apps (e.g., keyboard, terminal) in apps.allow when using handle_apps=suspend. Without a valid allowlist, apps may become unusable, requiring XBSctl safe via ADB.

XBSctl Commands

Control XtremeBS with the XBSctl command-line tool (run as root via su):

[!TIP]
Use XBSctl safe via ADB (adb shell XBSctl safe) if the device becomes unresponsive due to misconfiguration.

Usage Tips

1. Start Slow:

   • Enable one option at a time (e.g., handle_apps=nice) and test for 24 hours to ensure stability.
   • Avoid aggressive settings like disable_cores initially, especially on Samsung or OnePlus devices.

2. Debugging:

   • Check /data/local/tmp/XtremeBS/XtremeBS.status for CPU, WiFi, and Doze states.
   • Set log_level=3 and review /sdcard/XtremeBS.log for detailed logs if issues occur.
   • Run su -c ps -eo "%cpu pid cmd" | sort -n -k1,1 to identify high-CPU processes for proc_file.

3. Device-Specific Notes:

   • Samsung Devices: Avoid disable_cores and handle_cores to prevent reboots or SystemUI crashes.
   • OnePlus Devices: Disable low_ram to avoid random reboots.

4. Security:

   • Restrict config file permissions: chmod 600 /data/local/tmp/XtremeBS/*.
   • Avoid sharing configs, as they may include sensitive app data or cause instability on different devices.

FAQ

Q: My device soft-loops or SystemUI crashes. What do I do?
A: You likely enabled too many aggressive options. Enter safe mode with adb shell XBSctl safe, disable risky settings (e.g., disable_cores, low_ram), and test incrementally. Check logs for clues.

Q: Will XtremeBS brick my device?
A: No, it won’t cause hard bootloops. However, misconfigurations can cause lag, missed alarms, or crashes. Always back up your device.

Q: Is XtremeBS plug-and-play?
A: No, it requires manual configuration. Start with the default config and adjust based on your device’s needs. An app is in development to simplify this.

Q: How effective is XtremeBS?
A: With proper tuning, it can extend battery life significantly. Effectiveness depends on your config and device.

Q: Why does my config not take effect?
A: Ensure you run XBSctl reload or reboot after changes. Verify event names (v2) are valid and check logs for errors. Use the web UI to avoid syntax issues.

Q: Can I use XtremeBS with other battery-saving modules?
A: Yes, but conflicts may occur (e.g., with L Speed, Naptime). Disable overlapping features in other modules and test thoroughly.

Troubleshooting

• Unresponsive Device: Boot into recovery, edit /data/local/tmp/XtremeBS/XtremeBS.conf to set safemode=1, reboot, and fix the config.
• No Battery Improvement: Verify active events (XBSctl status in future releases or check logs). Try handle_apps=suspend with a robust allowlist.
• Missed Alarms/Notifications: Disable doze or handle_proc, as they may delay background tasks.
• Report Issues: Open a GitHub Issue with your config, device details, and logs.

Contributing

We welcome contributions! To contribute:

1. Fork the repository: DethByte64/Xtreme-Battery-Saver.

2. Submit pull requests with bug fixes, features, or documentation improvements.

3. Report bugs or suggest features via GitHub Issues.

Acknowledgments

• Thanks to the Magisk and KernelSU communities for root support.

• DerGoogler for MMRL and their work in MMAR

• Special thanks to NanKillBro for KernelSU testing.

• Gratitude to XDA and Reddit users for feedback and testing.

License

XtremeBS is released under the GPLv3 License.