Repository files navigation

You are probably wondering why I have chosen to write this script inBash Shell Script. The reason is very simple; I wanted a script with the minimum number of dependencies possible. To get this script up-and-running youtechnically only need thetemp.sh file, and theconfig file.

The current version of the script isversion 19.6.

This script is currently set up for Celsius. However, it can easily be modified for other temperature scales.

If you need any help configuring my script or don't know how to make it start automatically check theUSAGE.md file.

• comes with a more aggressive fan curve than the nvidia default (lower temps, louder noise)
• usesnvidia-settings commands
• automatically enables/disables GPU fan control (butnotCoolBits)
• very lightweight
• multiple GPU control with individual fan controller support
• makes use of a config file with explanations for each setting
• POSIX compliant

• a POSIX compliant shell; tested with recent versions ofbash anddash
• nvidia glx driver version greater than 304
• nvidia-settings for controlling the GPU(s)
• coreutils
• procps - you can comment out the functioncheck_already_running if you don't have it

• Download the .zip file straight from the GitHubs
• Extract it somewhere, and open a terminal to that directory
• Make sureCoolBits is enabled (seeUSAGE.md)
• Runsh temp.sh (or any compatable shell) or./temp.sh for a foreground process. Run with the option-D (case sensitive) for a background process (i.e../temp.sh -D). Note that usingsh or./ will automatically use your default shell.

• Choose a folder you want to download/install the script in
• git clone https://github.com/nan0s7/nfancurve
• Follow the last two steps under theGitHub guide area

There are unofficial AUR packages:

• Stable:nfancurve^AUR, maintained by@ReneHollander
• Git Master:nfancurve-git^AUR, outdated and unmaintained

Ensure the script and the config paths are correct.Move or copy the nfancurve.service file to /etc/systemd/user/nfancurve.service then enable and start the service with:

systemctl --user daemon-reloadsystemctl --user start nfancurve.servicesystemctl --user enable nfancurve.service

On some Distro's which are further behind in updates, or if there's a slight misconfiguration with services, you may encounter issues with the service file.

To work around this, you may change the following lines in thenfancurve.service file:

1. ChangeAfter=graphical-session.target toAfter=default.target
2. Remove the lineRequires=graphical-session.target
3. ChangeWantedBy=graphical-session.target toWantedBy=default.target
4. Under the[Service] heading, add the lineExecStartPre=/bin/sleep 20

Don't forget to reload and reenable the service:

systemctl --user daemon-reloadsystemctl reenable --user nfancurve.service

• @aryonoco, for being my multi-GPU guinea pig
• @civyshk, for making a Python fork
• @zJelly, for working on an AMD-GPU supporting fork
• @dpayne, for adding useful script parameters
• @Scrumplex, for adding check to avoid errors when config is missing, and initialising the AUR packages
• @stefmitropoulos, for greatly improving the way config files are loaded
• @mklement0, (stackoverflow) for aPOSIX implimentation of resolving file symlinks
• @xberg, for finding and fixing a bug with the multi-GPU side of the script
• @edave, for helping test the initial implimentation of multi-fan GPU support
• @louissmit, for helping test the final multi-fan GPU feature implimentation
• @D3473R, for adding an example systemd service file
• @ReneHollander, for maintaining and improving the stable AUR package
• @kenbeese, for making me aware of a multi-GPU bug
• @BryanHitchcock, for fixing an issue with single GPU, multi-fan configurations
• @mooninite, for fixing a couple of bugs

• make sure that "CoolBits" is enabled -not really the scope of this script
• possibly check the currently installed driver version -earlier versions used the GPUCurrentFanSpeed command
• add in areally detailed guide of how the script works
• add nouveau support (once they fix Pascal)
• add AMD support?
• make fans controllable without needing to use thenvidia-settings app (for headless support)