nvifan

A tool aimed at controlling NVIDIA GPU fans on Linux.


License
GPL-3.0
Install
pip install nvifan==0.2.0

Documentation

NVIFAN

Python 3.7+ PyPI Python Package using Conda Upload Python Package GitHub Repo Stars License

A tool aimed at controlling NVIDIA GPU fans on Linux.

中文版README

The program has been developed in Python, and its source code is conveniently hosted on GitHub.

Written by: Haomin Kong

If this program turns out to be beneficial for you, kindly consider showing your support by starring it on GitHub. Your recognition is greatly appreciated!

Usage

Install

pip install nvifan

Direct Run

sudo nvifan

or

# Use 'su' to run as root
su
nvifan

Tips

  • You can use nvifan --help to see the usage.
  • (Not recommended)You can use screen or tmux to keep the program running when you close the terminal.

Upgrade

We recommend using the official PyPI repository to upgrade the package. The third party PyPI mirrors are used to improve the download speed. But may an older version,so you can use this command to upgrade to the latest version.

pip install --upgrade nvifan -i https://pypi.python.org/simple

By the way, if you are using systemd, you can use the following command to restart the service after upgrading.

sudo systemctl restart nvifan

Install as Service(Recommended)

Install Service

sudo nvifan-install

Uninstall Service

sudo nvifan-uninstall

Install from Source

chmod +x install.sh
./install.sh

Build Wheel

chmod +x build.sh
./build.sh

Log

The log file is located at /var/log/nvi/nvifan.log.

If you want to view the log, you can use the following command:

sudo journalctl -u nvifan

or

cat /var/log/nvi/nvifan.log

If you want to report a bug, you should provide the log file. You can make an Issue on GitHub and attach the log file.

Gitee

We have a Gitee repository, which is a mirror of the GitHub repository.

https://gitee.com/a645162/nvi-fan-control

This repository is used to improve the download speed in China.

So that:

  • Please do not use this repository for development or make a Pull Request.
  • Please do not make an Issue on Gitee, because we do not check the Issue on Gitee.

Ref

Based on CoolGPUs and nvitop. Thanks for their work.