NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #1056 by repository stars
Latest stable
v0.10.0
Last release 15 days ago
07 Nov 2026
Release timing varies
gaps range from 8 days to 5 months
Nearly every release is documented
notes for 27 of 27 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
63 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
More reliable native charge limits on macOS 27. batt now accepts targets that macOS applies later instead of repeatedly reporting registration errors.
Since v0.9.0:
.dmg and open it (right-click open if macOS says it's damaged)batt.app to Applicationssudo xattr -r -d com.apple.quarantine /Applications/batt.app.batt.app.System Settings -> Battery -> Battery Health -> i -> Turn OFF Optimized Battery Charging. Built-in charge limit also need to be disabled if you are on macOS 26.4 or later.[!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
brew install batt
sudo brew services start batt # Do NOT forget sudo.
Disable macOS's optimized charging: System Settings -> Battery -> Battery Health -> i -> Turn OFF Optimized Battery Charging. Built-in charge limit also need to be disabled if you are on macOS 26.4 or later.
Just follow the installation steps again. After you open the new version of batt.app, click Upgrade Daemon... upgrade to the new daemon.
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
[!IMPORTANT] If you previously ran
battv0.7.3 or earlier, follow the one-time service-label migration before starting the service. When the Homebrew formula moved from v0.7.3 to v0.7.5, its service label changed fromcc.chlc.batttohomebrew.mxcl.batt.
brew update
sudo brew services stop batt # Do NOT forget sudo.
brew upgrade batt
sudo brew services start batt # Do NOT forget sudo.
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
Check your firmware version by running system_profiler SPHardwareDataType | grep -i firmware in Terminal. Do NOT rely on macOS version.
| Firmware Version | First macOS release | GUI | CLI (Prebuilt) | CLI (Build from Source) | Note |
|---|---|---|---|---|---|
6723.x.x |
macOS 11 Big Sur | ❌ | ❌ | ⚠️ | |
7429.x.x / 7459.x.x |
macOS 12 Monterey | ❌ | ⚠️ | ✅ | |
8419.x.x / 8422.x.x |
macOS 13 Ventura | ⚠️ | ⚠️ | ✅ | |
101xx.x.x |
macOS 14 Sonoma | ⚠️ | ⚠️ | ✅ | |
118xx.x.x |
macOS 15 Sequoia | ✅ | ✅ | ✅ | |
138xx.x.x / 18xxx.x.x |
macOS 26 Tahoe | ✅ | ✅ | ✅ | |
20356.0.0.0.15 ~ 20457.0.77.0.2 |
macOS 27 Golden Gate Developer Beta 1~3 | ✅ | ✅ | ✅ | Firmware-managed limits |
20457.0.125.0.2+ |
macOS 27 Golden Gate Developer Beta 4+ | ✅ | ✅ | ✅ | Native limits (10–99%, upper only); optional adapter mode or experimental no-drain; see docs |
| Other | Unknown | ❓ | ❓ | ❓ |
[!NOTE] Firmware version is different from macOS version. Old macOS versions may have newer firmware, e.g. macOS 15.8.2 has firmware
20457.41.3(macOS 27 Golden Gate versions).
[!NOTE] macOS 15.8 updates ship
20xxxfirmware but keep firmware-managed limits (upper and lower).
Your coding agent can read these notes before it upgrades. Set up the MCP server →
macOS 27 Golden Gate support. Apple gated the SMC charge-control keys behind a private entitlement, so batt now falls back to the native macOS charge
batt now falls back to the native macOS charge limit (PowerUIAgent) when direct SMC control is unavailable. On macOS 27 it sets exact targets from 10% to 99%, below the Settings slider's 80% minimum.
lower-limit-delta). If the battery is above the limit, macOS may drain it toward the target even while plugged in, and macOS may occasionally charge to 100%.batt charge now charges to your limit right away; batt charge full charges to 100% once. Your limit is left unchanged.20xxx firmware) keeps using firmware-managed limits.sudo batt adapter-mode enable) for gated firmware. It enforces upper and lower limits by cutting wall power. It works only while batt is awake and disables Force Discharge and auto-calibration.Since v0.8.0:
.dmg and open it (right-click open if macOS says it's damaged)batt.app to Applicationssudo xattr -r -d com.apple.quarantine /Applications/batt.app.batt.app.System Settings -> Battery -> Battery Health -> i -> Turn OFF Optimized Battery Charging. Built-in charge limit also need to be disabled if you are on macOS 26.4 or later.[!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
brew install batt
sudo brew services start batt # Do NOT forget sudo.
Disable macOS's optimized charging: System Settings -> Battery -> Battery Health -> i -> Turn OFF Optimized Battery Charging. Built-in charge limit also need to be disabled if you are on macOS 26.4 or later.
Just follow the installation steps again. After you open the new version of batt.app, click Upgrade Daemon... upgrade to the new daemon.
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
[!IMPORTANT] If you previously ran
battv0.7.3 or earlier, follow the one-time service-label migration before starting the service. When the Homebrew formula moved from v0.7.3 to v0.7.5, its service label changed fromcc.chlc.batttohomebrew.mxcl.batt.
brew update
sudo brew services stop batt # Do NOT forget sudo.
brew upgrade batt
sudo brew services start batt # Do NOT forget sudo.
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
Check your firmware version by running system_profiler SPHardwareDataType | grep -i firmware in Terminal. Do NOT rely on macOS version.
| Firmware Version | First macOS release | GUI | CLI (Prebuilt) | CLI (Build from Source) | Note |
|---|---|---|---|---|---|
6723.x.x |
macOS 11 Big Sur | ❌ | ❌ | ⚠️ | |
7429.x.x / 7459.x.x |
macOS 12 Monterey | ❌ | ⚠️ | ✅ | |
8419.x.x / 8422.x.x |
macOS 13 Ventura | ⚠️ | ⚠️ | ✅ | |
101xx.x.x |
macOS 14 Sonoma | ⚠️ | ⚠️ | ✅ | |
118xx.x.x |
macOS 15 Sequoia | ✅ | ✅ | ✅ | |
138xx.x.x / 18xxx.x.x |
macOS 26 Tahoe | ✅ | ✅ | ✅ | |
20356.0.0.0.15 ~ 20457.0.77.0.2 |
macOS 27 Golden Gate Developer Beta 1~3 | ✅ | ✅ | ✅ | Firmware-managed limits |
20457.0.125.0.2+ |
macOS 27 Golden Gate Developer Beta 4+ | ✅ | ✅ | ✅ | Native limits (10–99%, upper only) or opt-in adapter mode; see docs |
| Other | Unknown | ❓ | ❓ | ❓ |
[!NOTE] Firmware version is different from macOS version. Old macOS versions may have newer firmware, e.g. macOS 15.8.2 has firmware
20457.41.3(macOS 27 Golden Gate versions).
[!NOTE] macOS 15.8 updates ship
20xxxfirmware but keep firmware-managed limits (upper and lower).
Nothing published for this version
Nothing published for this version
macOS Golden Gate Developer Beta 1~3 support. macOS Golden Gate Developer Beta 4 is not yet supported.
Since v0.7.3:
batt status--for, or choose a duration from the GUI.Since v0.7.5:
--for flag to batt disable for scheduled re-enabling by @PrismaKisar in #143disable-for feature hardening and GUI features by @charlie0129 in #144--for in adapter disable command by @charlie0129 in f25fef3.dmg and open it (right-click open if macOS says it's damaged)batt.app to Applicationssudo xattr -r -d com.apple.quarantine /Applications/batt.app.batt.app.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.[!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
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.
Just follow the installation steps again. After you open the new version of batt.app, click Upgrade Daemon... upgrade to the new daemon.
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
[!IMPORTANT] If you previously ran
battv0.7.3 or earlier, follow the one-time service-label migration before starting the service. When the Homebrew formula moved from v0.7.3 to v0.7.5, its service label changed fromcc.chlc.batttohomebrew.mxcl.batt.
brew update
sudo brew services stop batt # Do NOT forget sudo.
brew upgrade batt
sudo brew services start batt # Do NOT forget sudo.
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
Check your firmware version by running system_profiler SPHardwareDataType | grep -i firmware in Terminal. Do NOT rely on macOS version.
| Firmware Version | First macOS release | GUI | CLI (Prebuilt) | CLI (Build from Source) | Note |
|---|---|---|---|---|---|
6723.x.x |
macOS 11 Big Sur | ❌ | ❌ | ⚠️ | |
7429.x.x / 7459.x.x |
macOS 12 Monterey | ❌ | ⚠️ | ✅ | |
8419.x.x / 8422.x.x |
macOS 13 Ventura | ⚠️ | ⚠️ | ✅ | |
101xx.x.x |
macOS 14 Sonoma | ⚠️ | ⚠️ | ✅ | |
118xx.x.x |
macOS 15 Sequoia | ✅ | ✅ | ✅ | |
138xx.x.x / 18xxx.x.x |
macOS 26 Tahoe | ✅ | ✅ | ✅ | |
20356.0.0.0.15 ~ 20457.0.77.0.2 |
macOS 27 Golden Gate Developer Beta 1~3 | ✅ | ✅ | ✅ | Firmware-managed limits; see below |
20457.0.125.0.2+ |
macOS 27 Golden Gate Developer Beta 4 | ❌ | ❌ | ❌ | work in progress, wait for next release |
| Other | Unknown | ❓ | ❓ | ❓ |
[!NOTE] Firmware version is different from macOS version. Old macOS versions may have newer firmware, e.g. macOS 15 with firmware
138xx.x.x(macOS Tahoe version).
Nothing published for this version
Basic macOS 27 firmware `20xxx` support.
v0.7.3 - v0.7.4:
20xxx support.Since v0.7.4:
batt statusSince v0.7.3:
.dmg and open it (right-click open if macOS says it's damaged)batt.app to Applicationssudo xattr -r -d com.apple.quarantine /Applications/batt.app.batt.app.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.[!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
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.
Just follow the installation steps again. After you open the new version of batt.app, click Upgrade Daemon... upgrade to the new daemon.
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
[!IMPORTANT] If you previously ran
battv0.7.3 or earlier withsudo brew services, follow the one-time service-label migration before starting the service. When the Homebrew formula moved from v0.7.3 to v0.7.5, its service label changed fromcc.chlc.batttohomebrew.mxcl.batt.
brew update
sudo brew services stop batt # Do NOT forget sudo.
brew upgrade batt
sudo brew services start batt # Do NOT forget sudo.
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
Check your firmware version by running system_profiler SPHardwareDataType | grep -i firmware in Terminal. Do NOT rely on macOS version.
| Firmware Version | First macOS release | GUI | CLI (Prebuilt) | CLI (Build from Source) | Note |
|---|---|---|---|---|---|
6723.x.x |
macOS 11 Big Sur | ❌ | ❌ | ⚠️ | |
7429.x.x / 7459.x.x |
macOS 12 Monterey | ❌ | ⚠️ | ✅ | |
8419.x.x / 8422.x.x |
macOS 13 Ventura | ⚠️ | ⚠️ | ✅ | |
101xx.x.x |
macOS 14 Sonoma | ⚠️ | ⚠️ | ✅ | |
118xx.x.x |
macOS 15 Sequoia | ✅ | ✅ | ✅ | |
138xx.x.x / 18xxx.x.x |
macOS 26 Tahoe | ✅ | ✅ | ✅ | |
20xxx.x.x |
macOS 27 Golden Gate | ✅ | ✅ | ✅ | Firmware-managed limits; see README |
| Other | Unknown | ❓ | ❓ | ❓ |
[!NOTE] Firmware version is different from macOS version. Old macOS versions may have newer firmware, e.g. macOS 15 with firmware
138xx.x.x(macOS Tahoe version).
> Homebrew installation is known to have issues due to breaking changes from Homebrew #141. Use GUI or installation script if you encounter problems.
20xxx support..dmg and open it (right-click open if macOS says it's damaged)batt.app to Applicationssudo xattr -r -d com.apple.quarantine /Applications/batt.app.batt.app.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.[!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
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.
Just follow the installation steps again. After you open the new version of batt.app, click Upgrade Daemon... upgrade to the new daemon.
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.
Check your firmware version by running system_profiler SPHardwareDataType | grep -i firmware in Terminal. Do NOT rely on macOS version.
| Firmware Version | First macOS release | GUI | CLI (Prebuilt) | CLI (Build from Source) | Note |
|---|---|---|---|---|---|
6723.x.x |
macOS 11 Big Sur | ❌ | ❌ | ⚠️ | |
7429.x.x / 7459.x.x |
macOS 12 Monterey | ❌ | ⚠️ | ✅ | |
8419.x.x / 8422.x.x |
macOS 13 Ventura | ⚠️ | ⚠️ | ✅ | |
101xx.x.x |
macOS 14 Sonoma | ⚠️ | ⚠️ | ✅ | |
118xx.x.x |
macOS 15 Sequoia | ✅ | ✅ | ✅ | |
138xx.x.x / 18xxx.x.x |
macOS 26 Tahoe | ✅ | ✅ | ✅ | |
20xxx.x.x |
macOS 27 Golden Gate | ✅ | ✅ | ✅ | Firmware-managed limits; see README |
| Other | Unknown | ❓ | ❓ | ❓ |
[!NOTE] Firmware version is different from macOS version. Old macOS versions may have newer firmware, e.g. macOS 15 with firmware
138xx.x.x(macOS Tahoe version).
> Homebrew installation is known to have issues due to breaking changes from Homebrew. #141
.dmg and open it (right-click open if macOS says it's damaged)batt.app to Applicationssudo xattr -r -d com.apple.quarantine /Applications/batt.app.batt.app.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.[!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)
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.
Just follow the installation steps again. After you open the new version of batt.app, click Upgrade Daemon... upgrade to the new daemon.
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.
| Firmware Version | GUI | CLI (Prebuilt) | CLI (Build from Source) | Note |
|---|---|---|---|---|
6723.x.x |
❌ | ❌ | ⚠️ | |
7429.x.x / 7459.x.x |
❌ | ⚠️ | ✅ | |
8419.x.x / 8422.x.x |
⚠️ | ⚠️ | ✅ | |
10151.x.x |
⚠️ | ⚠️ | ✅ | |
11881.x.x |
✅ | ✅ | ✅ | |
13822.x.x |
✅ | ✅ | ✅ | |
18000.x.x |
✅ | ✅ | ✅ | |
20xxx.x.x |
❌ | ❌ | ❌ | Wait for future versions of batt |
| Other | ❓ | ❓ | ❓ |
[!NOTE] Firmware version is different from macOS version. You can check your firmware version by running
system_profiler SPHardwareDataType | grep -i firmwarein Terminal.
Nothing published for this version
TL;DR: The output of batt status is more machine-readable. This release is useful for scripting. Regular users can skip this release.
TL;DR: The output of batt status is more machine-readable. This release is useful for scripting. Regular users can skip this release.
--json flag to batt status for machine-readable output by @jpesce in #122.dmg and open it (right-click open if macOS says it's damaged)batt.app to Applicationssudo xattr -r -d com.apple.quarantine /Applications/batt.app.batt.app.System Settings -> Battery -> Battery Health -> i -> Trun OFF Optimized Battery Charging[!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
Just follow the installation steps again. After you open the new version of batt.app, click Upgrade Daemon... upgrade to the new daemon.
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.
| 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 | ❓ | ❓ | ❓ |
[!NOTE] Firmware version is different from macOS version. You can check your firmware version by running
system_profiler SPHardwareDataType | grep -i firmwarein Terminal.
fix: correctly reset MagSafe LED to system state when batt is disabled (limit=100%) by @charlie0129 in 1017302177e3c4a5d6c7f6783e526997ffc24ab1
.dmg and open it (right-click open if macOS says it's damaged)batt.app to Applicationssudo xattr -r -d com.apple.quarantine /Applications/batt.app.batt.app.System Settings -> Battery -> Battery Health -> i -> Trun OFF Optimized Battery Charging[!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
Just follow the installation steps again. After you open the new version of batt.app, click Upgrade Daemon... upgrade to the new daemon.
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.
| 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 | ❓ | ❓ | ❓ |
[!NOTE] Firmware version is different from macOS version. You can check your firmware version by running
system_profiler SPHardwareDataType | grep -i firmwarein Terminal.
Full Changelog: https://github.com/charlie0129/batt/compare/v0.7.0...v0.7.1
Nothing published for this version
fix: swap client and daemon version return value order (#99) by @g-a-c in 18c6eb2c8281ce9a87a7d43c90dc15ed3d439536
.dmg and open it (right-click open if macOS says it's damaged)batt.app to Applicationssudo xattr -r -d com.apple.quarantine /Applications/batt.app.batt.app.System Settings -> Battery -> Battery Health -> i -> Trun OFF Optimized Battery Charging[!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
Just follow the installation steps again. After you open the new version of batt.app, click Upgrade Daemon... upgrade to the new daemon.
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.
| 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 | ❓ | ❓ | ❓ |
[!NOTE] Firmware version is different from macOS version. You can check your firmware version by running
system_profiler SPHardwareDataType | grep -i firmwarein Terminal.
Full Changelog: https://github.com/charlie0129/batt/compare/v0.6.0...v0.7.0
*Auto calibration* is finally here! Thanks to the work by @brookqin. It will automatically complete a full charging cycle to help calibrate reported b
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.
.dmg and open it (right-click open if macOS says it's damaged)batt.app to Applicationssudo xattr -r -d com.apple.quarantine /Applications/batt.app.batt.app.System Settings -> Battery -> Battery Health -> i -> Trun OFF Optimized Battery Charging[!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
Just follow the installation steps again. After you open the new version of batt.app, click Upgrade Daemon... upgrade to the new daemon.
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.
| 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 | ❓ | ❓ | ❓ |
[!NOTE] Firmware version is different from macOS version. You can check your firmware version by running
system_profiler SPHardwareDataType | grep -i firmwarein Terminal.
Full Changelog: https://github.com/charlie0129/batt/compare/v0.5.3...v0.6.0
Nothing published for this version
feat: add always-off option to MagSafe LED control by @wanderingmeow in https://github.com/charlie0129/batt/pull/70
always-off option to MagSafe LED control by @wanderingmeow in https://github.com/charlie0129/batt/pull/70.dmg and open it (right-click open if macOS says it's damaged)batt.app to Applicationssudo xattr -r -d com.apple.quarantine /Applications/batt.app.batt.app.System Settings -> Battery -> Battery Health -> i -> Trun OFF Optimized Battery Charging[!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
Just follow the installation steps again. After you open the new version of batt.app, click Upgrade Daemon... upgrade to the new daemon.
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.
| 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+ |
✅ | ✅ | ✅ |
[!NOTE] Firmware version is different from macOS version. You can check your firmware version by running
system_profiler SPHardwareDataType | grep -i Firmwarein Terminal.
Full Changelog: https://github.com/charlie0129/batt/compare/v0.5.2...v0.5.3
fix: reintroduce Power Flow via ObjC observer + selector NSTimer by @peterneutron in https://github.com/charlie0129/batt/pull/66
.dmg and open it (right-click open if macOS says it's damaged)batt.app to Applicationssudo xattr -r -d com.apple.quarantine /Applications/batt.app.batt.app.System Settings -> Battery -> Battery Health -> i -> Trun OFF Optimized Battery Charging[!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
Just follow the installation steps again. After you open the new version of batt.app, click Upgrade Daemon... upgrade to the new daemon.
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.
| 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+ |
✅ | ✅ | ✅ |
[!NOTE] Firmware version is different from macOS version. You can check your firmware version by running
system_profiler SPHardwareDataType | grep -i Firmwarein Terminal.
Full Changelog: https://github.com/charlie0129/batt/compare/v0.5.1...v0.5.2
Nothing published for this version
fix: use MaxCapacity (mAh) and signed W in status by @peterneutron in https://github.com/charlie0129/batt/pull/65
.dmg and open it (right-click open if macOS says it's damaged)batt.app to Applicationssudo xattr -r -d com.apple.quarantine /Applications/batt.app.batt.app.System Settings -> Battery -> Battery Health -> i -> Trun OFF Optimized Battery Charging[!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
Just follow the installation steps again. After you open the new version of batt.app, click Upgrade Daemon... upgrade to the new daemon.
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.
| 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+ |
✅ | ✅ | ✅ |
[!NOTE] Firmware version is different from macOS version. You can check your firmware version by running
system_profiler SPHardwareDataType | grep -i Firmwarein Terminal.
Full Changelog: https://github.com/charlie0129/batt/compare/v0.5.0...v0.5.1
Add prevent-system-sleep while charging by @MabaKalox in https://github.com/charlie0129/batt/pull/51
.dmg and open it (right-click open if macOS says it's damaged)batt.app to Applicationssudo xattr -r -d com.apple.quarantine /Applications/batt.app.batt.app.System Settings -> Battery -> Battery Health -> i -> Trun OFF Optimized Battery Charging[!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
Just follow the installation steps again. After you open the new version of batt.app, click Upgrade Daemon... upgrade to the new daemon.
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
| 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+ |
✅ | ✅ | ✅ |
[!NOTE] Firmware version is different from macOS version. You can check your firmware version by running
system_profiler SPHardwareDataType | grep -i Firmwarein Terminal.
Full Changelog: https://github.com/charlie0129/batt/compare/v0.4.1...v0.5.0
Nothing published for this version
Nothing published for this version
Fixed adapter controlling compatibility issues in macOS Tahoe. Thanks @oliver408i
<img width="191" alt="SCR-20250624-lbmb-3" src="https://github.com/user-attachments/assets/4bef52d7-8483-49bd-b579-736b87c81a52" /> <img width="206" alt="SCR-20250624-lbmb-2" src="https://github.com/user-attachments/assets/f3731a00-d973-4d67-8b4a-d57595e3842f" /> <img width="450" alt="SCR-20250624-lbmb-4" src="https://github.com/user-attachments/assets/a9d3c2eb-5d41-400e-b042-b79f6e8decd0" />
.dmg and open it (right-click open if macOS says it's damaged)batt.app to Applicationssudo xattr -r -d com.apple.quarantine /Applications/batt.app.batt.app.System Settings -> Battery -> Battery Health -> i -> Trun OFF Optimized Battery Charging[!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
Just follow the installation steps again. After you open the new version of batt.app, click Upgrade Daemon... upgrade to the new daemon.
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
| 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+ |
⚠️ | ⚠️ | ⚠️ |
[!NOTE] Firmware version is different from macOS version. You can check your firmware version by running
system_profiler SPHardwareDataType | grep -i Firmwarein Terminal.
Experimental GUI (file an issue if you find bugs)
<img width="191" alt="SCR-20250624-lbmb-3" src="https://github.com/user-attachments/assets/4bef52d7-8483-49bd-b579-736b87c81a52" /> <img width="206" alt="SCR-20250624-lbmb-2" src="https://github.com/user-attachments/assets/f3731a00-d973-4d67-8b4a-d57595e3842f" /> <img width="450" alt="SCR-20250624-lbmb-4" src="https://github.com/user-attachments/assets/a9d3c2eb-5d41-400e-b042-b79f6e8decd0" />
.dmg and open it (right-click open if macOS says it's damaged)batt.app to Applicationssudo xattr -r -d com.apple.quarantine /Applications/batt.app.batt.app.System Settings -> Battery -> Battery Health -> i -> Trun OFF Optimized Battery Charging[!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
Just follow the installation steps again. After you open the new version of batt.app, click Upgrade Daemon... upgrade to the new daemon.
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
| 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) | ⚠️ | ⚠️ | ⚠️ |
Full Changelog: https://github.com/charlie0129/batt/compare/v0.3.7...v0.4.0
Nothing published for this version
Nothing published for this version
Experimental GUI (file an issue if you find bugs)
<img width="191" alt="SCR-20250624-lbmb-3" src="https://github.com/user-attachments/assets/4bef52d7-8483-49bd-b579-736b87c81a52" /> <img width="206" alt="SCR-20250624-lbmb-2" src="https://github.com/user-attachments/assets/f3731a00-d973-4d67-8b4a-d57595e3842f" /> <img width="450" alt="SCR-20250624-lbmb-4" src="https://github.com/user-attachments/assets/a9d3c2eb-5d41-400e-b042-b79f6e8decd0" />
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.
.dmg file and open it (right-click open if macOS says it's damaged)batt.app to Applicationsbatt.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.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 batt
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
| 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: https://github.com/charlie0129/batt/issues/34#issuecomment-2958535441
Nothing published for this version
Allow charging to be enabled immediately when setting a new limit (if current charge is below the limit).
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
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
Upgrading to this version should be fine for users using macOS Monterey to macOS Sequoia. If you are on macOS Big Sur, you can stay at v0.1.0 or build it by yourself.
[!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.
You can read the issue comment for details: https://github.com/charlie0129/batt/issues/34#issuecomment-2958535441
This update fixes an incorrect system clock reading, which is related to the mitigation added in v0.3.5.
This update fixes an incorrect system clock reading, which is related to the mitigation added in v0.3.5.
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
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
Upgrading to this version should be fine for users using macOS Monterey or later. If you are on macOS Big Sur, you can stay at v0.1.0 or build it by yourself.
This update adds a workaround to mitigate an issue where macOS may unexpectedly stop batt or fail to notify batt about the sleep state transitions. As
This update adds a workaround to mitigate an issue where macOS may unexpectedly stop batt or fail to notify batt about the sleep state transitions. As a result, charging can be unexpectedly enabled. A small number of users are affected by this issue.
Option 1: Installation Script
bash <(curl -fsSL https://github.com/charlie0129/batt/raw/master/hack/install.sh)
Option 2: Homebrew
brew install batt
sudo brew services start batt
Please use the same method (Installation Script / Homebrew) as you installed to upgrade batt. Using both methods will cause conflicts.
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
Upgrading to this version should be file for users using macOS Monterey or later. If you are on macOS Big Sur, you can stay at v0.1.0 or build it by yourself.
Nothing published for this version
This update adds a workaround to mitigate an issue where macOS may unexpectedly stop batt or fail to notify batt about the sleep state transitions. As
This update adds a workaround to mitigate an issue where macOS may unexpectedly stop batt or fail to notify batt about the sleep state transitions. As a result, charging can be unexpectedly enabled. A small number of users are affected by this issue.
VERSION=v0.3.5-beta.1 bash <(curl -fsSL https://github.com/charlie0129/batt/raw/master/hack/install.sh)
Where is Homebrew? There is no Homebrew release for a pre-release, you can either wait for a production release or uninstall the Homebrew version.
This update mainly resolves an issue where the MagSafe LED may not turn green after waking up even if you chose not to control MagSafe LED.
This update mainly resolves an issue where the MagSafe LED may not turn green after waking up even if you chose not to control MagSafe LED.
Option 1: Installation Script
bash <(curl -fsSL https://github.com/charlie0129/batt/raw/master/hack/install.sh)
Option 2: Homebrew
brew install batt
sudo brew services start batt
Please use the same method (Installation Script / Homebrew) as you installed to upgrade batt. Using both methods will cause conflicts.
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
Upgrading to this version should be file for users using macOS Monterey or later. If you are on macOS Big Sur, you can stay at v0.1.0 or build it by yourself.
fix: magsafe led may keep in the off-state @charlie0129 in 18ce7df
This update mainly resolves an issue where the MagSafe LED may not turn green after waking up (if you have batt magsafe-led enabled).
Option 1: Installation Script
bash <(curl -fsSL https://github.com/charlie0129/batt/raw/master/hack/install.sh)
Option 2: Homebrew
brew install batt
sudo brew services start batt
Please use the same method (Installation Script / Homebrew) as you installed to upgrade batt. Using both methods will cause conflicts.
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
Upgrading to this version should be file for users using macOS Monterey or later. If you are on macOS Big Sur, you can stay at v0.1.0 or build it by yourself.
Nothing published for this version
fix: do not turn off led when waking and controlling magsafe led is disabled @charlie0129 in 27e3b11c
Option 1: Installation Script
bash <(curl -fsSL https://github.com/charlie0129/batt/raw/master/hack/install.sh)
Option 2: Homebrew
brew install batt
sudo brew services start batt
Please use the same method (Installation Script / Homebrew) as you installed to upgrade batt. Using both methods will cause conflicts.
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
Upgrading to v0.3.2 should be fine for users using macOS Monterey or later. If you are on macOS Big Sur, you can stay at v0.1.0 or build it by yourself.
Nothing published for this version
Nothing published for this version
v0.3.1 is intended to improve the integration with Homebrew and no new features are added. If you are using v0.3.0 already, you can skip this version.
v0.3.1 is intended to improve the integration with Homebrew and no new features are added. If you are using v0.3.0 already, you can skip this version.
Option 1: Installation Script
bash <(curl -fsSL https://github.com/charlie0129/batt/raw/master/hack/install.sh)
Option 2: Homebrew
brew install batt
sudo brew services start batt
Please use the same method (Installation Script / Homebrew) as you installed to upgrade batt. Using both methods will cause conflicts.
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
Upgrading to v0.3.1 should be fine for users using macOS Monterey or later. If you are on macOS Big Sur, you can stay at v0.1.0 or build it by yourself.
Nothing published for this version
feat: allow config reloading using SIGHUP @charlie0129 in 0fbc86f5
batt disable command to quickly set charge limit to 100 @charlie0129 in 5eea0b1aOne line version (to install or upgrade):
bash <(curl -fsSL https://github.com/charlie0129/batt/raw/master/hack/install.sh)
Just be sure to read the on-screen instructions.
See:
Upgrading to v0.3.0 should be fine for users using macOS Monterey or later. If you are on macOS Big Sur, you can stay at v0.1.0 or build it by yourself.
chore: add message about adapter is disabled by @charlie0129 in 90df4aa
Full Changelog: https://github.com/charlie0129/batt/compare/v0.2.0...v0.2.1
One line version (to install or upgrade):
bash <(curl -fsSL https://github.com/charlie0129/batt/raw/master/hack/install.sh)
Just be sure to read the on-screen instructions.
See:
Upgrading to v0.2.0 should be fine for users using macOS Monterey or later. If you are on macOS Big Sur, you can stay at v0.1.0 or build v0.2.0 by yourself (v0.2.0 itself should run on macOS Big Sur if you build it yourself).
Nothing published for this version
Nothing published for this version
__feat: magsafe led control by @exidler in https://github.com/charlie0129/batt/pull/3__
batt status @charlie0129 in de5eabc0Full Changelog: https://github.com/charlie0129/batt/compare/v0.1.0...v0.2.0
One line version (to install or upgrade):
bash <(curl -fsSL https://github.com/charlie0129/batt/raw/master/hack/install.sh)
Just be sure to read the on-screen instructions.
See:
Upgrading to v0.2.0 should be fine for users using macOS Monterey or later. If you are on macOS Big Sur, you can stay at v0.1.0 or build v0.2.0 by yourself (v0.2.0 itself should run on macOS Big Sur if you build it yourself).
Nothing published for this version
chore: enhance message when set limit to 100% by @charlie0129 in 404e6ee
Full Changelog: https://github.com/charlie0129/batt/compare/v0.1.0-beta.4...v0.1.0
Currently, batt is known to be fairly stable now. So here we are, the first non-beta release. This release focuses on stability so several new features will not be included in this release because they are not considered to be well-tested. If you want the latest features, you can try the upcoming beta releases.
If you encounter any problem, please post it on GitHub Issues so I can help. You can find logs from /tmp/batt.log. I appreciate your input.
batt daemon have its log levels set to
debugfor easy debugging so you may find a lot of logs. You can truncate it and only keep the useful parts before reporting.
Nothing published for this version
chore: more accurate description about the battery voltage by @charlie0129 in a070c0a
This is a beta release. Although I have tested and verified most features on my own Mac, this doesn't mean they will work on other computers. Since we will typically only charge MacBooks less than once per day, it becomes particularly hard to test edge cases. Therefore, rather extensive testing is required before batt can be marked as production-ready.
If you encounter any problem, please post it on GitHub Issues so I can help. You can find logs from /tmp/batt.log. I appreciate your input.
Beta versions have their log levels set to
debugfor easy debugging so you may find a lot of logs. You can truncate it and only keep the useful parts before reporting.
Full Changelog: https://github.com/charlie0129/batt/compare/v0.1.0-beta.3...v0.1.0-beta.4
Nothing published for this version
feat: reset any charge limits on uninstall by @charlie0129 in dba2a97
This is a beta release. Although I have tested and verified most features on my own Mac, this doesn't mean they will work on other computers. Since we will typically only charge MacBooks less than once per day, it becomes particularly hard to test edge cases. Therefore, rather extensive testing is required before batt can be marked as production-ready.
Please use this pre-release with caution. If you encounter any problem, posting them on GitHub issues is helpful for everyone. You can get the logs of batt daemon from /tmp/batt.log.
Full Changelog: https://github.com/charlie0129/batt/compare/v0.1.0-beta.2...v0.1.0-beta.3
Nothing published for this version
This is a beta version. Although I have tested and verified most features on my own Mac, this doesn't mean they will work on other computers. Since we
This is a beta version. Although I have tested and verified most features on my own Mac, this doesn't mean they will work on other computers. Since we will typically only charge MacBooks less than once per day, it becomes particularly hard to test edge cases. Therefore, rather extensive testing is required before batt can be marked as production-ready.
Please use this pre-release with caution. If you encounter any problem, posting them on GitHub issues is helpful for everyone. You can get the logs of batt daemon from /tmp/batt.log.
Full Changelog: https://github.com/charlie0129/batt/compare/v0.1.0-beta.1...v0.1.0-beta.2
Nothing published for this version
This is a beta version. Although I have tested and verified most features on my own Mac, this doesn't mean they will work on other computers. Since we
This is a beta version. Although I have tested and verified most features on my own Mac, this doesn't mean they will work on other computers. Since we will typically only charge MacBooks less than once per day, it becomes particularly hard to test edge cases. Therefore, rather extensive testing is required before batt can be marked as production-ready.
Please use this pre-release with caution. If you encounter any problem, posting them on GitHub issues is helpful for everyone. You can get the logs of batt daemon from /tmp/batt.log.
Full Changelog: https://github.com/charlie0129/batt/compare/v0.1.0-alpha.1...v0.1.0-beta.1
Nothing published for this version
This is the first release. Although I have tested and verified most features on my own Mac, this doesn't mean they will work on other computers. Since
This is the first release. Although I have tested and verified most features on my own Mac, this doesn't mean they will work on other computers. Since we will typically only charge MacBooks less than once per day, it becomes particularly hard to test edge cases. Therefore, rather extensive testing is required before batt can be marked as production-ready.
Please use this pre-release with caution. If you encounter any problem, posting them on GitHub issues is helpful for everyone. You can get the logs of batt daemon from /tmp/batt.log.
One column per quarter.