Skip to content

quinsaiz/ppd-cpu-boost

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Power Profiles Daemon CPU Boost Sync

The systemd service, which automatically synchronizes CPU Turbo Boost settings with the active power profile set power-profiles-daemon.

This provides instant and energy-efficient switching between modes.

How it works

The script automatically detects the CPU architecture and uses the appropriate control file and logic.

CPU Control File Logic
AMD (cpufreq) /sys/devices/system/cpu/cpufreq/boost 1 = Boost ON
Intel (intel_pstate) /sys/devices/system/cpu/intel_pstate/no_turbo 0 = Turbo ON

Profile Logic

PPD Profile (powerprofilesctl) Action Effect
performance Enable Boost/Turbo Maximum CPU performance.
balanced or power-saver Disable Boost/Turbo Reduced heat and power consumption.

Requirements

  • python
  • python-gobject
  • power-profiles-daemon

Installation

I. Arch Linux / AUR (Recommended)

Once packaged, users can install via an AUR helper (e.g., yay or paru).

  1. Clone the PKGBUILD repository:

    git clone https://aur.archlinux.org/ppd-cpu-boost.git
    
    cd ppd-cpu-boost
  2. Build and Install (using makepkg -si to clean up source files):

    makepkg -si
  3. Activate a service in systemd

    sudo systemctl enable --now ppd-cpu-boost.service

II. Manual Installation

  1. Use the provided install.sh script for manual setup. Clone the repository:

    git clone https://github.com/quinsaiz/ppd-cpu-boost.git
    
    cd ppd-cpu-boost
  2. Install (requires root privileges):

    sudo ./install.sh

Uninstallation

Method Command
Pacman sudo pacman -R ppd-cpu-boost
Manual sudo ./install.sh --uninstall or sudo ./install.sh -u

Usage and Diagnostics

Check Service Status:

systemctl status ppd-cpu-boost

View Logs (Real-time):

sudo journalctl -u ppd-cpu-boost -f

Verify the Effect (e.g., on AMD systems):

watch -n1 cat /sys/devices/system/cpu/cpufreq/boost

About

Synchronizes CPU Turbo Boost state (Intel/AMD) with the active power profile managed by power-profiles-daemon.

Resources

License

Stars

Watchers

Forks

Contributors