#fan #sysfs #yaml-configuration #fancontrol #hwmon

app fanctl

Fancontrol replacement in Rust with YAML configuration

8 releases (4 breaking)

0.6.0 Dec 3, 2021
0.5.1 Jul 15, 2021
0.4.2 Oct 8, 2020
0.4.1 Aug 7, 2020
0.2.0 Jun 24, 2019

#501 in Configuration

GPL-3.0 license

38KB
1K SLoC

fanctl

fanctl is a replacement for fancontrol from lm_sensors meant to have a more fine-grained control interface in its config file.

Motivation

fancontrol's configuration is pretty cryptic, and controlling it is quite hard. Rust was chosen as the implementation language of choice due to the problems that can arise if the program controlling your fans crashes un-cleanly (potentially causing hardware to overheat).

Usage

Building

fanctl is built with cargo, the package manager and build system for Rust crates.

cargo build --release

The built binary will be in target/release/fanctl.

Running

fancl -c <CONFIG_FILE>

Configuration

An example configuration file can be found at fanctl.yml.

More detailed information can be found in the documentation. The config module is a good place to start.

You can build the documentation locally with cargo.

# Will build documentation in target/doc
cargo doc --no-deps

License

fanctl is released under the GNU General Public License v3.0.

See the COPYING file for more information.

Dependencies

~5–7MB
~126K SLoC