v1.0.0

tp-fanctl v1.0.0

Adaptive fan controller for ThinkPad laptops. Auto-switches between quiet and gaming fan profiles based on CPU load.

Features

• Hysteresis with asymmetric thresholds: 12s to engage gaming, 30s to disengage
• Counter decay absorbs transient spikes — no thrashing
• Profile switching via SIGHUP reload (no fan reset during switch)
• System tray applet — purple Q (quiet), blue G (gaming)
• Manual override from tray menu
• Clean shutdown restores BIOS fan control

Install

git clone https://github.com/onyxdigitaldev/tp-fanctl
cd tp-fanctl
sudo ./install.sh
sudo reboot

Packages

• RPM: spec file included for Fedora/COPR builds
• DEB: debian/ packaging included for Debian/Ubuntu builds
• Manual: install.sh works on any distro with thinkfan

Requirements

• ThinkPad with thinkpad_acpi kernel module
• thinkfan installed
• Python 3.10+