Metadata-Version: 2.1
Name: py3status-cpu-governor
Version: 0.1.2
Summary: py3status monitor to show the state of your cpu governor
Home-page: https://github.com/mcgillij/py3status-cpu-governor
License: MIT
Keywords: cpu,governor,py3status,i3,monitor
Author: mcgillij
Author-email: mcgillivray.jason@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: Environment :: X11 Applications
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Desktop Environment :: Window Managers
Classifier: Topic :: System :: Hardware
Classifier: Topic :: System :: Monitoring
Requires-Dist: py3status (>=3.34,<4.0)
Project-URL: Documentation, https://github.com/mcgillij/py3status-cpu-governor
Project-URL: Repository, https://github.com/mcgillij/py3status-cpu-governor
Description-Content-Type: text/markdown

# py3status-cpu-governor
Python module for py3status to show the cpu_governor state in i3

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

``` bash
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\""'
```

## Screenshot
![py3status cpu_governor](https://raw.githubusercontent.com/mcgillij/py3status-cpu-governor/main/images/cpu_governor.png)

## Pre-reqs
* i3
* py3status

## Installation
### From Git
``` bash
git clone https://github.com/mcgillij/py3status-cpu-governor.git
mkdir -p ~/.i3/py3status && cd ~/.i3/py3status
ln -s <PATH_TO_CLONED_REPO>/src/py3status-cpu-governor/cpu_governor.py ./
```

### With Pip
``` bash
pip install py3status-cpu-governor
```

### Building From AUR (Arch)
``` bash
git clone https://aur.archlinux.org/py3status-cpu-governor.git
cd py3status-cpu-governor.git
makechrootpkg -c -r $HOME/$CHROOT
```

### Installing Arch package
``` bash
sudo pacman -U --asdeps py3status-cpu-governor-*-any.pkg.tar.zst
```

## Configuration

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

``` bash
order += "cpu_governor"
```

And restart your i3 session.

