pifanctl

Rapsberry Pi PWM fan controller based on gpiozero

⚠️ This is rough software I developed for my own usage. Use at your own risk! See TODO below.

It's very simple software though and is easily removable so you could try and see for yourself.

Installation

Run the install script with root privileges: sudo sh install.sh. This will:

• install the program at /opt/pifanctl
• create a Python virtual environement at /opt/pifanctl/.venv
• create and copy a systemd service to /etc/systemd/system/pifan.service

The service can then be managed via systemd: sudo systemctl start pifan.service

Removing

# Stop, disable and remove the the systemd service
sudo systemctl stop pifan.service
sudo systemctl disable pifan.service
sudo rm /etc/systemd/system/pifan.service

# Remove the program files
sudo rm -rf /opt/pifanctl

TODO

• proper dependencies documentation
• more built-in profiles
• custom profiles (config file?)
• consolidate install script
• pin selection
• proper CLI to control the fan
• logging / prometheus export

NOTES

When upgrading to Debian 13 from Debian 12, the service failed to start because the gpiozero dependency was not found anymore. My guess is that a Python version change must have broken the virtual environment. I had to rm /opt/pifanctl and reinstall sudo sh install.sh to fix the issue.