What's Changed

Highlights

Since v0.7.3:

• macOS Golden Gate Developer Beta 1~3 support. macOS Golden Gate Developer Beta 4 is not yet supported.
• Battery health percentage report in batt status
• Scheduled charge-limit and power-adapter controls. Temporarily disable charge limits or force battery use with --for, or choose a duration from the GUI.

Commits

Since v0.7.5:

• feat: add --for flag to batt disable for scheduled re-enabling by @PrismaKisar in #143
• feat: disable-for feature hardening and GUI features by @charlie0129 in #144
• fix: honor disabled pre-sleep charging protection after missed loops by @charlie0129 in 81442d5
• feat: add --for in adapter disable command by @charlie0129 in f25fef3

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. Built-in charge limit also need to be disabled if you are on macOS 26.4 or later.

CLI version

Option 1: Installation Script (Recommended)

bash <(curl -fsSL https://github.com/charlie0129/batt/raw/master/hack/install.sh)

Option 2: 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. Built-in charge limit also need to be disabled if you are on macOS 26.4 or later.

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.

Homebrew service-label migration

if sudo launchctl print system/cc.chlc.batt >/dev/null 2>&1; then
  sudo launchctl bootout system/cc.chlc.batt
fi
sudo rm -f /Library/LaunchDaemons/cc.chlc.batt.plist

Compatibility Matrix

Check your firmware version by running system_profiler SPHardwareDataType | grep -i firmware in Terminal. Do NOT rely on macOS version.

• ❌: Unsupported
• ✅: Supported
• ⚠️: Not verified, but expected to work.
• ❓: Unknown, please raise an issue if you have tested it.

v0.8.0 Latest

Latest

Compare

Choose a tag to compare

What's Changed

Highlights

v0.7.3 - v0.7.4:

• Basic macOS 27 firmware 20xxx support.
• Reduced binary size. From 7.4MB -> 2.9MB compressed.

Since v0.7.4:

• Battery health report in batt status

Commits

Since v0.7.3:

• feat: macos 27 firmware support and capability checks in #142. Thanks @ashwinr64 for investigating SMC keys on macOS 27 #140 comment actuallymentor/battery#469, also @lilianmoraru for the initial PR.
• refactor: remove darwinkit and use native objc instead by @charlie0129 in 7e62b7f
• feat: show battery health in batt status by @charlie0129 in 8148dfc

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. Built-in charge limit also need to be disabled if you are on macOS 26.4 or later.

CLI version

Option 1: Installation Script (Recommended)

bash <(curl -fsSL https://github.com/charlie0129/batt/raw/master/hack/install.sh)

Option 2: 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. Built-in charge limit also need to be disabled if you are on macOS 26.4 or later.

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.

Homebrew service-label migration

if sudo launchctl print system/cc.chlc.batt >/dev/null 2>&1; then
  sudo launchctl bootout system/cc.chlc.batt
fi
sudo rm -f /Library/LaunchDaemons/cc.chlc.batt.plist

Compatibility Matrix

Check your firmware version by running system_profiler SPHardwareDataType | grep -i firmware in Terminal. Do NOT rely on macOS version.

• ❌: Unsupported
• ✅: Supported
• ⚠️: Not verified, but expected to work.
• ❓: Unknown, please raise an issue if you have tested it.

v0.7.5

Compare

Choose a tag to compare

What's Changed

Highlights

• Basic macOS 27 firmware 20xxx support.
• Reduced binary size. From 7.4MB -> 2.9MB compressed.

Commits

• feat: macos 27 firmware support and capability checks in #142. Thanks @ashwinr64 for investigating SMC keys on macOS 27 #140 comment actuallymentor/battery#469, also @lilianmoraru for the initial PR.
• refactor: remove darwinkit and use native objc instead by @charlie0129 in 7e62b7f

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. Built-in charge limit also need to be disabled if you are on macOS 26.4 or later.

CLI version

Option 1: Installation Script (Recommended)

bash <(curl -fsSL https://github.com/charlie0129/batt/raw/master/hack/install.sh)

Option 2: Homebrew

Homebrew installation is known to have issues due to breaking changes from Homebrew #141. Use GUI or installation script if you encounter problems.

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. Built-in charge limit also need to be disabled if you are on macOS 26.4 or later.

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

Homebrew installation is known to have issues due to breaking changes from Homebrew #141. Use GUI or installation script if you encounter problems.

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

Check your firmware version by running system_profiler SPHardwareDataType | grep -i firmware in Terminal. Do NOT rely on macOS version.

• ❌: Unsupported
• ✅: Supported
• ⚠️: Not verified, but expected to work.
• ❓: Unknown, please raise an issue if you have tested it.

v0.7.4

Compare

Choose a tag to compare

What's Changed

• fix: disable charging when batt execution is interrupted by macos by @charlie0129 in 569ec86 (fixes #123)

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. Built-in charge limit also need to be disabled if you are on macOS 26.4 or later.

CLI 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)

Homebrew installation is known to have issues due to breaking changes from Homebrew. #141

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. Built-in charge limit also need to be disabled if you are on macOS 26.4 or later.

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

Homebrew installation is known to have issues due to breaking changes from Homebrew. #141

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

• ❌: Unsupported
• ✅: Supported
• ⚠️: Not verified, but expected to work.
• ❓: Unknown, please raise an issue if you have tested it.

v0.7.3

Compare

Choose a tag to compare

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

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

• ❌: Unsupported
• ✅: Supported
• ⚠️: Not verified, but expected to work.
• ❓: Unknown, please raise an issue if you have tested it.

v0.7.2

Compare

Choose a tag to compare

What's Changed

• fix: correctly reset MagSafe LED to system state when batt is disabled (limit=100%) by @charlie0129 in 1017302
• feat: disable calibration when limit is 100 by @charlie0129 in d0888e7
• feat: display different quit tooltip when daemon is not installed by @charlie0129 in dee6bd3

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

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

• ❌: Unsupported
• ✅: Supported
• ⚠️: Not verified, but expected to work.
• ❓: Unknown, please raise an issue if you have tested it.

Full Changelog: v0.7.0...v0.7.1

v0.7.1

Compare

Choose a tag to compare

What's Changed

• fix: swap client and daemon version return value order (#99) by @g-a-c in 18c6eb2
• chore: add error when daemon is too old to report version by @charlie0129 in 2faefc8
• chore: make sure /usr/local/bin exists when installing by @charlie0129 in f7aef55
• feat: new batt schedule command for fully automatic calibration by @brookqin in 5e177d7
• fix: darwinkit cffi by @charlie0129 in 8ed6546
• feat: support setting calibration hold duration and discharge limit by @charlie0129 in 51a686c

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

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

• ❌: Unsupported
• ✅: Supported
• ⚠️: Not verified, but expected to work.
• ❓: Unknown, please raise an issue if you have tested it.

Full Changelog: v0.6.0...v0.7.0

v0.7.0

Compare

Choose a tag to compare

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

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

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

• ❌: Unsupported
• ✅: Supported
• ⚠️: Not verified, but expected to work.
• ❓: Unknown, please raise an issue if you have tested it.

New Contributors

• @brookqin made their first contribution in #90

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

v0.6.0

Compare

Choose a tag to compare

What's Changed

• feat: add always-off option to MagSafe LED control by @wanderingmeow in #70
• chore: fix incorrect power metrics on M4 Pro chips by @peterneutron in #78

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

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

• ❌: Unsupported
• ✅: Supported

New Contributors

• @wanderingmeow made their first contribution in #70

Full Changelog: v0.5.2...v0.5.3

v0.5.3

Compare

Choose a tag to compare

What's Changed

• fix: reintroduce Power Flow via ObjC observer + selector NSTimer by @peterneutron in #66

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

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

• ❌: Unsupported
• ✅: Supported

Full Changelog: v0.5.1...v0.5.2

v0.5.2

Compare

Choose a tag to compare