Shell Linux gpu graphics temperature nvidia Bash efficient
Need help with nfancurve?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.


A small and lightweight POSIX script for using a custom fan curve in Linux for those with an Nvidia GPU.

160 Stars 29 Forks GNU General Public License v3.0 278 Commits 5 Opened issues

Services available

Need anything else?


You are probably wondering why I have chosen to write this script in ~~Bash~~ 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 you technically only need the
file, and the

The current version of the script is version 19.4.

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 the file.


  • comes with a more aggressive fan curve than the nvidia default (lower temps, louder noise)
  • uses
  • automatically enables/disables GPU fan control (but not
  • 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 of
  • nvidia glx driver
    version greater than 304
  • nvidia-settings
    for controlling the GPU(s)
  • coreutils
  • procps
    - you can comment out the function
    if you don't have it

How to install


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


  • Choose a folder you want to download/install the script in
  • git clone
  • Follow the last two steps under the GitHub guide area

Arch Linux

There are unofficial AUR packages: - Stable: nfancurveAUR, maintained by @ReneHollander - Git Master: nfancurve-gitAUR, outdated and unmaintained

Using the systemd service

Replace NFANCURVE_PATH with the nfancurve path. Move or copy the nfancurve.service file to /etc/systemd/user/nfancurve.service then enable and start the service with:

systemctl --user daemon-reload
systemctl --user start nfancurve.service
systemctl --user enable nfancurve.service

Honourable mentions

  • @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 a POSIX 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 a really detailed guide of how the script works
  • add nouveau support (once they fix Pascal)
  • add AMD support?
  • make fans controllable without needing to use the
    app (for headless support)

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.