charlie0129/batt v0.8.0

on GitHub

What's Changed

Highlights

Since v0.7.3:

• macOS Golden Gate Developer Beta 1~3 support. macOS Golden Gate Developer Beta 4 is not yet supported.
• Battery health percentage report in batt status
• Scheduled charge-limit and power-adapter controls. Temporarily disable charge limits or force battery use with --for, or choose a duration from the GUI.

Commits

Since v0.7.5:

• feat: add --for flag to batt disable for scheduled re-enabling by @PrismaKisar in #143
• feat: disable-for feature hardening and GUI features by @charlie0129 in #144
• fix: honor disabled pre-sleep charging protection after missed loops by @charlie0129 in 81442d5
• feat: add --for in adapter disable command by @charlie0129 in f25fef3

Installation

GUI version

1. Download .dmg and open it (right-click open if macOS says it's damaged)
2. Drag batt.app to Applications
3. macOS may say it's damaged when you try to run it (it's NOT) and wants you to move it to trash. To fix it, run this in Terminal: sudo xattr -r -d com.apple.quarantine /Applications/batt.app.
4. Run batt.app.
5. Follow the MenuBar UI to install or upgrade.
6. Disable macOS's optimized charging: System Settings -> Battery -> Battery Health -> i -> Trun OFF Optimized Battery Charging. Built-in charge limit also need to be disabled if you are on macOS 26.4 or later.

CLI version

Option 1: Installation Script (Recommended)

bash <(curl -fsSL https://github.com/charlie0129/batt/raw/master/hack/install.sh)

Option 2: Homebrew

brew install batt
sudo brew services start batt # Do NOT forget sudo.

Disable macOS's optimized charging: System Settings -> Battery -> Battery Health -> i -> Trun OFF Optimized Battery Charging. Built-in charge limit also need to be disabled if you are on macOS 26.4 or later.

Upgrade

GUI version

Just follow the installation steps again. After you open the new version of batt.app, click Upgrade Daemon... upgrade to the new daemon.

CLI version

Please use the same method (Installation Script / Homebrew) as you installed to upgrade batt. Using both methods will cause conflicts. If you don't remember how you installed it, you can check the binary location by running which batt. If it is in /usr/local/bin, you probably used the installation script. If it is in /opt/homebrew/bin, you probably used Homebrew.

Option 1: Installation Script

bash <(curl -fsSL https://github.com/charlie0129/batt/raw/master/hack/install.sh)
# Yes, the command is the same as installing.

Option 2: Homebrew

brew update
sudo brew services stop batt # Do NOT forget sudo.
brew upgrade batt
sudo brew services start batt # Do NOT forget sudo.

Homebrew service-label migration

if sudo launchctl print system/cc.chlc.batt >/dev/null 2>&1; then
  sudo launchctl bootout system/cc.chlc.batt
fi
sudo rm -f /Library/LaunchDaemons/cc.chlc.batt.plist

Compatibility Matrix

Check your firmware version by running system_profiler SPHardwareDataType | grep -i firmware in Terminal. Do NOT rely on macOS version.

• ❌: Unsupported
• ✅: Supported
• ⚠️: Not verified, but expected to work.
• ❓: Unknown, please raise an issue if you have tested it.