charlie0129/batt v0.5.0 on GitHub

What's Changed

Add prevent-system-sleep while charging by @MabaKalox in #51
Fix typos in README by @look in #58
feat(gui): Add Power Flow submenu with detailed tooltips by @peterneutron in #55

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

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
brew upgrade batt
sudo brew services start batt

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

@MabaKalox made their first contribution in #51
@look made their first contribution in #58
@peterneutron made their first contribution in #55

Full Changelog: v0.4.1...v0.5.0