v0.7.5

What's Changed

Highlights

v0.7.3 - v0.7.4:

• Basic macOS 27 firmware 20xxx support.
• Reduced binary size. From 7.4MB -> 2.9MB compressed.

Since v0.7.4:

• Battery health report in batt status

Commits

Since v0.7.3:

• feat: macos 27 firmware support and capability checks in #142. Thanks @ashwinr64 for investigating SMC keys on macOS 27 #140 comment actuallymentor/battery#469, also @lilianmoraru for the initial PR.
• refactor: remove darwinkit and use native objc instead by @charlie0129 in 7e62b7f
• feat: show battery health in batt status by @charlie0129 in 8148dfc

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

Note

Command-Line version is already included if you have installed the GUI version.

Option 1: Installation Script (Recommended)

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

Option 2: Homebrew

Homebrew installation is known to have issues due to breaking changes from Homebrew #141. Use GUI or installation script if you encounter problems.

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

Homebrew installation is known to have issues due to breaking changes from Homebrew #141. Use GUI or installation script if you encounter problems.

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

Compatibility Matrix

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

Firmware Version	First macOS release	GUI	CLI (Prebuilt)	CLI (Build from Source)	Note
6723.x.x	macOS 11 Big Sur	❌	❌	⚠️
7429.x.x / 7459.x.x	macOS 12 Monterey	❌	⚠️	✅
8419.x.x / 8422.x.x	macOS 13 Ventura	⚠️	⚠️	✅
101xx.x.x	macOS 14 Sonoma	⚠️	⚠️	✅
118xx.x.x	macOS 15 Sequoia	✅	✅	✅
138xx.x.x / 18xxx.x.x	macOS 26 Tahoe	✅	✅	✅
20xxx.x.x	macOS 27 Golden Gate	✅	✅	✅	Firmware-managed limits; see README
Other	Unknown	❓	❓	❓

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

Note

Firmware version is different from macOS version. Old macOS versions may have newer firmware, e.g. macOS 15 with firmware 138xx.x.x (macOS Tahoe version).