What's Changed
TL;DR: The output of batt status is more machine-readable. This release is useful for scripting. Regular users can skip this release.
- fix: direct CLI output to stdout instead of stderr by @clarabennettdev in #121
- feat: add
--jsonflag tobatt statusfor machine-readable output by @jpesce in #122
Installation
GUI version
- Download
.dmgand open it (right-click open if macOS says it's damaged) - Drag
batt.apptoApplications - 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 OFFOptimized 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.x.x
| ✅ | ✅ | ✅ |
| Other | ❓ | ❓ | ❓ |
- ❌: 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. You can check your firmware version by running system_profiler SPHardwareDataType | grep -i firmware in Terminal.