Skip to main content

py3status monitor to show the state of your cpu governor

Project description


Python module for py3status to show the cpu_governor state in i3


This is handy if you manage your governor manually with something like or use gamemode

alias performance_mode='echo performance | sudo tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor'
alias powersave_mode='echo powersave | sudo tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor'
alias schedutil_mode='echo schedutil | sudo tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor'
alias cpu_frequency_watch='watch -n.5 "cat /proc/cpuinfo | grep \"^[c]pu MHz\""'


py3status cpu_governor


  • i3
  • py3status


From Git

git clone
mkdir -p ~/.i3/py3status && cd ~/.i3/py3status
ln -s <PATH_TO_CLONED_REPO>/src/py3status-cpu-governor/ ./

With pip, pipenv or poetry

pip install py3status-cpu-governor
pipenv install py3status-cpu-governor
poetry add py3status-cpu-governor && poetry install

With yay

yay -S py3status-cpu-governor

Building Arch package w/PKGBUILD

git clone
cd py3status-cpu-governor.git
makechrootpkg -c -r $HOME/$CHROOT

Installing Arch package

sudo pacman -U --asdeps py3status-cpu-governor-*-any.pkg.tar.zst


add the following line to your ~/.config/i3/i3status.conf

order += "cpu_governor"

And restart your i3 session.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

py3status-cpu-governor-0.1.3.tar.gz (3.6 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page