charlie0129/batt v0.6.0 on GitHub

What's Changed

Auto calibration is finally here! Thanks to the work by @brookqin. It will automatically complete a full charging cycle to help calibrate reported battery percentage. If you have suggestions or encounter problems, please open GitHub issues.

chore: add app icon by in #82 by @invisiblepixel in #83
feat: auto calibration workflow and SSE event by @brookqin in #90
feat: add a warning about mismatched client and daemon versions by @charlie0129 in #93
fix: make sure charging is enabled in charging phase during calibration by @charlie0129 in #97

Installation

GUI version

Download .dmg and open it (right-click open if macOS says it's damaged)
Drag batt.app to Applications
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.
Run batt.app.
Follow the MenuBar UI to install or upgrade.
Disable macOS's optimized charging: System Settings -> Battery -> Battery Health -> i -> Trun OFF Optimized Battery Charging

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 (If you prefer 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

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.

Compatibility Matrix

Firmware Version	GUI	CLI (Prebuilt)	CLI (Build from Source)
`6723.x.x`	❌	❌	✅
`7429.x.x` / `7459.x.x`	❌	✅	✅
`8419.x.x` / `8422.x.x`	✅	✅	✅
`10151.x.x`	✅	✅	✅
`11881.x.x`	✅	✅	✅
`13822+`	✅	✅	✅

❌: Unsupported
✅: Supported

Note

Firmware version is different from macOS version. You can check your firmware version by running system_profiler SPHardwareDataType | grep -i Firmware in Terminal.

New Contributors

@brookqin made their first contribution in #90

Full Changelog: v0.5.3...v0.6.0