actuallymentor/battery
Battery
Battery is a command-line and graphical utility for macOS that manages battery charging behavior to prolong battery lifespan. It functions as a charge limiter, allowing users to set a maximum charge threshold—typically 80%—and maintain that limit across reboots and even when the application is closed. The tool also includes a battery sensor calibration feature that discharges the battery to a low level and then fully recharges it to restore accurate capacity reporting.
The project distinguishes itself by offering both a CLI and a GUI for controlling charging behavior, supporting custom percentage targets and manual toggling of the charging circuit regardless of whether the power adapter is connected. It can maintain battery charge within a user-specified percentage range by automatically stopping and resuming charging, and it can drain the battery to a target level by blocking power input from the adapter. Settings persist across system restarts through a state file, ensuring consistent battery protection policies.
Battery provides real-time monitoring of power adapter events through ACPI netlink hooks, adjusting charging behavior in response to plug/unplug events. It runs as a background service managed by systemd, with command-line tools communicating with the daemon via Unix domain sockets or D-Bus. The tool also displays current SMC status, charge percentage, and estimated time remaining.
Features
- Charge Limiters - Limits battery charging to 80% when plugged in to prolong battery lifespan, even after rebooting.
- CLI and GUI Battery Managers - Provides both a command-line and graphical interface for controlling battery charging limits and behavior.
- ACPI Parsers - Monitors power adapter plug/unplug events via ACPI netlink to adjust charging behavior in real time.
- ACPI Netlink Event Hooks - Monitors power adapter plug/unplug events via ACPI netlink to adjust charging behavior in real time.
- Embedded Controller Charge Controls - Interacts with the embedded controller to manage battery charging hardware at the kernel level.
- Range-Based Charge Maintainers - Keeps the battery charge within a user-specified percentage range by automatically stopping and resuming charging.
- Laptop Battery Managers - Keeps the battery charge within a user-specified percentage range to prolong its lifespan.
- macOS Battery Managers - Manages battery charge thresholds and charging behavior specifically on Apple Silicon and Intel Macs.
- Battery Sensor Calibrators - Recalibrates the battery sensor by fully discharging and recharging to restore accurate capacity reporting.
- Systemd Services - Runs as a background service managed by systemd to enforce charge policies across reboots.
- Battery Power Optimization - Blocks power input from the adapter until the battery drains to a user-specified percentage.
- Filesystem Polling - Periodically reads battery percentage from the sysfs filesystem to detect charge level changes.
- Boot-Persistent State Persisters - Stores charge limit and mode settings in a file that survives reboots and application restarts.
- Graphical Charge Managers - Ships a graphical interface to adjust battery charging limits without requiring command-line usage.
- Manual Charge Overrides - Ships a manual override to immediately enable or disable charging regardless of the automatic schedule.
- Persistent - Keeps the 80% charge limit active after system restarts and even when the tray app is closed.
- Persistent Charge Configurations - Preserves configured charge limits across system restarts and even when the tray application is closed.
- Target Charge Level Chargers - Charges the battery to a target percentage and then stops charging automatically.
- Battery Calibrators - Discharges and recharges the battery to restore accurate capacity reporting.
- Battery Dischargers - Blocks power input from the adapter until the battery drains to a user-defined percentage.
- Sysfs Polling Monitors - Periodically reads battery percentage from sysfs to detect charge level changes and trigger actions.
