A powerful, user-centric tool for managing battery health and power states on Apple Silicon Macs. ChargeControl allows you to set custom charging limits, manually discharge your battery while plugged in, and receive audio warnings when charging starts.
Unlike standard macOS battery management, ChargeControl gives you direct control over the System Management Controller (SMC) to enforce your preferences using a professional Absolute Threshold approach.
| General | Advanced | Protection |
|---|---|---|
 |
 |
 |
| Analytics | History | Menu Bar |
|---|---|---|
 |
 |
 |
- Custom Charge Limiting: Set a maximum charge percentage (50%–100%) to reduce battery wear.
- Smart Hysteresis: Avoids "micro-cycling" by waiting for the battery to drop below a specific floor before resuming charge.
- Lower Limit Re-engagement: Define a "Start Charging at" floor to manage the re-engagement gap. Your Mac will stay on AC power but won't charge the battery until it naturally drops below this limit.
- Active Floating Mode: Once the Max Limit is reached, your Mac will actively disconnect the power adapter virtually to let the battery "float" down to the Start Limit, then charge back up. This keeps the battery in constant motion rather than staying idle at a high voltage.
- Pause Charging: Manually stop the charging process. Your Mac will continue to run from the power adapter without charging the battery.
- Forced Battery Power: Virtually disconnect the power adapter to run entirely on battery. Useful for reducing charge level without physically unplugging.
- Automatic Discharging: Automatically switch to battery power if your charge is above the set limit, then reconnect AC once the limit is reached.
- Top Up Mode: Easily override limits to charge to 100% with a single click. Perfect for travel preparation.
- Audio Warnings: Configurable sound notification when the system starts charging. Choose from a custom bundled sound or any macOS system alert (Ping, Hero, Basso, and more).
- Heat Protection: Automatically pauses charging if the battery temperature exceeds a user-defined threshold.
- Sleep & Clamshell Management: Stay awake during critical charging or discharging tasks, ensuring limits are respected in Clamshell Mode.
- MagSafe LED Sync: Automatically changes the MagSafe connector color based on charging state (Orange = Charging, Green = Limit Reached, Off = Discharging).
- Historical Charts: View 60-second telemetry data (Battery Level, Power Flow) in the History tab (Requires Power User Mode).
- Automation CLI: Control and monitor everything from the terminal using the included
cctool. - Power User Analytics: Detailed hardware telemetry including Voltage, Amperage, Cycle Count, and multiple thermal sensors.
- Hardware: Apple Silicon Mac (M1, M2, M3, M4, or later).
- Operating System: macOS 13.0 (Ventura) or later.
- Development: Swift 5.9+ (included with Xcode).
Choose your preferred way to install ChargeControl.
- Go to the Releases page.
- Download the latest
ChargeControl.dmg. - Double-click the DMG and drag ChargeControl to your Applications folder.
If you have Homebrew installed, run:
brew tap will2022/chargecontrol
brew install --cask will2022/chargecontrol/chargecontrolRun this command to automatically download and install the latest release:
curl -sL https://raw.githubusercontent.com/will2022/ChargeControl/main/install.sh | bash- Clone the repository:
git clone https://github.com/will2022/ChargeControl.git cd ChargeControl - Build the app:
./build.sh ./package.sh # To generate the DMG - Move
build/ChargeControl.appto/Applications.
Because ChargeControl is currently distributed independently and interacts with low-level system hardware (SMC), you will likely encounter macOS security warnings.
When you first try to open the app, macOS may block it because it isn't signed with an Apple Developer Certificate.
- The Fix: Don't just double-click it. Right-click (or Control-click) the app icon and select Open. This will present a dialog with an "Open" button that isn't usually there, allowing you to bypass the check.
Once opened, the app needs to install a background helper daemon (ChargeControlDaemon) to talk to your battery hardware.
- The Fix: You will be prompted for your Administrator Password. This is required for the app to enforce your battery limits while your Mac is asleep or on the lock screen.
You may see a system notification that "ChargeControl" has added a background item. This is normal and necessary for the daemon to stay active.
The cc command-line tool allows you to control the app from the terminal.
- If you installed via Homebrew or the One-Liner, the CLI is already installed!
- If you installed via the DMG or built from source, you can symlink it manually:
sudo ln -s /Applications/ChargeControl.app/Contents/MacOS/cc /usr/local/bin/cc- General Tab: Manage your Max/Start limits and MagSafe/Audio notifications.
- Advanced Tab: Control manual and automatic discharge behaviors, including Floating Mode and Power User Mode.
- Protection Tab: Configure Heat Protection and Sleep/Clamshell inhibition settings.
- Analytics & History: View real-time telemetry and historical performance charts (Unlocks via Power User Mode).
- Override Warnings: Look for the yellow banner in Settings if a high-priority feature (like Heat Protection or Top Up Mode) is currently overriding your limits.
The cc tool allows for powerful automation and scripting:
cc status # Show current battery and daemon status
cc pause # Manually pause charging
cc resume # Revert to automatic charging limits (enforce Start/Max)
cc force # Force battery power (virtual adapter disconnect)
cc unforce # Re-enable power adapter
cc topup # Start Top Up to 100%
cc limit 80 # Set the Max Charge Limit to 80%If settings aren't applying or the UI isn't updating:
- Ensure the app is in
/Applications. - Restart the daemon manually:
sudo killall ChargeControlDaemon
- Re-open the app.
You can monitor the app's behavior by checking the logs:
- App Logs:
ChargeControl/app.log(in the project folder). - System Logs:
log show --predicate 'subsystem == "com.chargecontrol.daemon"' --last 5m
ChargeControl uses an Absolute Threshold approach with a state-based monitor.
graph TD
Start([Check Battery State]) --> HeatCheck{Heat Protection?}
HeatCheck -- Triggered --> Disable[Disable Charging]
HeatCheck -- Normal --> FullCheck{Top Up Mode?}
FullCheck -- Yes --> Enable[Enable Charging]
FullCheck -- No --> ManualCheck{Manual Pause/Force?}
ManualCheck -- Yes --> Disable
ManualCheck -- No --> LimitCheck{Capacity vs Limits}
LimitCheck -- ">= Max Limit" --> Disable
LimitCheck -- "< Start Limit" --> Enable
LimitCheck -- "In Between" --> Stay[Maintain Current State]
Enable --> End([Wait for next update])
Disable --> End
Stay --> End
ChargeControl interacts with the AppleSMC using the following keys:
CH0C/CHTE: Charging control (0 = Enable, 1 = Disable).CHIE/CH0J: Power adapter isolation (0 = Connected, 8/32 = Isolated).ACLC: MagSafe LED control (0 = System, 1 = Off, 3 = Green, 4 = Orange).B0Te,TC0P,TG0P,Ts0P: Thermal sensors (Battery, CPU, GPU, Palm Rest).B0AC,B0AV: Real-time Amperage and Voltage.B0CT,B0FC,B0DC: Cycle Count, Full Capacity, and Design Capacity.
ChargeControl writes directly to the SMC charging control keys to enforce limits. State changes take effect immediately through macOS's power management subsystem.
- Custom Charge Limiting
- Lower Limit Re-engagement: Define a floor below which charging will not restart. (Absolute Threshold).
- Active Floating Mode: Actively disconnect adapter to force discharge between limits.
- Top Up Mode: Easily override limits to charge to 100% with a single click.
- Forced Battery Power: Forces the MacBook to run on battery even when plugged in.
- Automatic Discharging: Drain battery to the set limit if currently above it.
- Virtual Adapter Toggle
- Heat Protection: Automatically pauses charging if battery temperature exceeds a threshold.
- Sleep & Clamshell Management: Respect limits even in Clamshell Mode and during active charging.
- Pause Background Activity: Reduce system load during critical charging.
- Calibration Mode: Automated 100% -> 10% -> 100% cycle to sync the fuel gauge.
- Scheduling: Recurring maintenance tasks (weekly/monthly).
- MagSafe LED Synchronization: Reflect software state on the MagSafe connector light.
- Automation & Scripting: Standalone
ccCLI tool for terminal control.
- Power Flow Dashboard: Real-time visualization of energy distribution between the power adapter, the battery, and the system components.
- Advanced Battery Stats: Displays detailed health metrics including cycle count, original design capacity, current maximum capacity, and precise temperature readings from internal sensors.
- Historical Data: Persistent SQLite logging and SwiftUI Charts.
If ChargeControl helps you keep your battery healthy, consider supporting its development: