auto-cpufreq(1)
Automatically scales CPU frequency and power management based on system load and battery status.
Synopsis
auto-cpufreq [OPTION]Description
auto-cpufreq is a tool that automatically switches CPU frequency scaling governors and power management settings based on whether the system is running on battery or AC power. It dynamically adjusts CPU frequencies to optimize performance and battery life without manual intervention.
The tool manages CPU frequency scaling through Linux kernel drivers and can set performance profiles, throttling limits, and turbo boost settings. It runs as a systemd service and continuously monitors system state to apply appropriate power profiles.
Common options
| Flag | What it does |
|---|---|
--install | Install auto-cpufreq as a systemd service and enable it on startup |
--remove | Remove auto-cpufreq from systemd and disable automatic management |
--monitor | Display CPU frequency and power management status in real-time without making changes |
--turbo=auto | Automatically manage turbo/boost settings based on power state |
--turbo=always | Always enable CPU turbo/boost regardless of power state |
--turbo=never | Disable CPU turbo/boost for maximum battery life |
--charger | Set frequency scaling for AC power (performance profile) |
--battery | Set frequency scaling for battery power (power saving profile) |
--config | Use a custom configuration file instead of the default |
--help | Display help message and exit |
Examples
Install auto-cpufreq as a permanent systemd service that auto-starts on boot
sudo auto-cpufreq --installDisplay real-time CPU frequency and current power profile without making any system changes
auto-cpufreq --monitorEnable automatic turbo boost management (enabled on AC, disabled on battery)
sudo auto-cpufreq --turbo=autoCheck if the auto-cpufreq service is running and enabled
sudo systemctl status auto-cpufreqUninstall auto-cpufreq from systemd and restore manual frequency management
sudo auto-cpufreq --removeMonitor system using a custom configuration file
sudo auto-cpufreq --config=/etc/auto-cpufreq.conf --monitor