github charlie0129/batt v0.7.2

8 hours ago

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 --json flag to batt status for machine-readable output by @jpesce in #122

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

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.

Don't miss a new batt release

NewReleases is sending notifications on new releases.