What's Changed
- Experimental GUI (file an issue if you find bugs)
- Increases delay to enable charging after batt is stopped by macOS from 60s to 80s to fix some edge cases.
How to Install / Upgrade GUI Version
This is the macOS App with Menu Bar.
- CLI is also included.
- If you have previously installed CLI versions, you can uninstall it, but you don't have to. batt will try handle it if you don't.
- Download
.dmgfile and open it (right-click open if macOS says it's damaged) - Drag
batt.apptoApplications - Run
batt.app. Remove quarantine first if macOS says it's damaged (it's NOT) and wants you to move it to trash, or doesn't want to open:sudo xattr -r -d com.apple.quarantine /Applications/batt.app. - Follow the MenuBar UI to install or upgrade.
How to Install CLI Version
This is the pure command line 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 battHow to Upgrade 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
brew upgrade batt
sudo brew services start battCompatibility
| GUI | CLI (Prebuilt) | CLI (Build from Source) | |
|---|---|---|---|
| macOS Big Sur (11) | ❌ | ❌ | ✅ |
| macOS Monterey (12) | ❌ | ✅ | ✅ |
| macOS Ventura (13) | ✅ | ✅ | ✅ |
| macOS Sonoma (14) | ✅ | ✅ | ✅ |
| macOS Sequoia (15) | ✅ | ✅ | ✅ |
| macOS Tahoe (26) | ❌ | ❌ | ❌ |
Warning
macOS Tahoe 26 is not supported because Apple has removed the functionality that batt relies on to control the battery. Once a MacBook is upgraded to macOS Tahoe, this functionality is almost permanently removed, even if macOS is downgraded afterwards. As such, until a new battery controlling method is found, we don't recommend upgrading to macOS Tahoe. Or you can use other tools that supports macOS Tahoe.
You can read the issue comment for details: #34 (comment)