https://github.com/rahmedi/thinkfan-cli
Controlling your thinkpads fan using command line
https://github.com/rahmedi/thinkfan-cli
fancontrol thinkfan thinkpad
Last synced: 6 months ago
JSON representation
Controlling your thinkpads fan using command line
- Host: GitHub
- URL: https://github.com/rahmedi/thinkfan-cli
- Owner: rahmedi
- Created: 2025-06-09T23:40:06.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-12-31T13:29:07.000Z (6 months ago)
- Last Synced: 2026-01-04T19:49:03.933Z (6 months ago)
- Topics: fancontrol, thinkfan, thinkpad
- Language: Rust
- Homepage:
- Size: 23.4 KB
- Stars: 16
- Watchers: 0
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# thinkfan-cli
**A minimalist, fast, and terminal-native fan control tool for ThinkPads.**
Directly interacts with `/proc/acpi/ibm/fan` for setting fan levels, no dependency on `thinkfan`.
---
## ✨ Features
* Set manual fan levels instantly
* Reads and writes directly to IBM ACPI fan interface
* No daemons or background services required
* Reading fan status instantly
---
## 📦 Installation
### IMPORTANT!!!
Please enable thinkpad acpi module or thinkfan-cli will not work
```bash
sudo modprobe thinkpad_acpi fan_control=1
```
### 📦 Arch Linux (via AUR)
```bash
yay -S thinkfan-cli
```
### 🔧 Manual (from source)
```bash
git clone https://github.com/rahmedi/thinkfan-cli.git
cd thinkfan-cli
cargo build --release
sudo cp target/release/thinkfan-cli /usr/bin/
```
---
## 🚀 Usage
```bash
thinkfan-cli -s auto # Switch to Auto controlled fan mode
thinkfan-cli -s 3 # Set fan to level 3 manually (0–7)
```
Note: Requires root privileges to write to `/proc/acpi/ibm/fan`.
---
## 💬 Feedback & Contributions
Open an issue, suggest a feature, or submit a PR!
Tested on T480 | X220 | R61i - reports for other models welcome.
---
## 💙 Author
Maintained by [rahmed](https://github.com/rahmedi)
Licensed under the GPL v3 License.