Skip to content

Fan Control v2.0.1 - Windows WMI Control

Latest

Choose a tag to compare

@vindeckyy vindeckyy released this 18 Sep 22:08
· 9 commits to main since this release

Fan Control v2.0.1

Windows hardware-control release plus a self-contained Linux AppImage.

Windows

Download the executables directly - each is a single self-contained file, no Python installation required:

  • fan-control.exe - desktop dashboard (Edge WebView2 / bundled browser fallback).
  • fan-ctl.exe - command-line client (status, profile, mode, set, curves, diagnose, ...).
  • fan-daemon.exe - background thermal-control daemon.

Highlights:

  • Real fan control on Uniwill/Tongfang ECs: windows_wmi talks to EC RAM through the ACPI WMI AcpiTest_MULong interface, the same channel the OEM control center uses.
    • Manual duty through EC user fan mode and the direct PWM registers (0x1804/0x1809, 0-200 scale), with release back to firmware automatic control.
    • EC CPU/GPU temperatures and fan tachometer (RPM) readouts.
    • Hardware-verified on a Gateway GWTN156-2BK (Tongfang GK5NR0O firmware).
  • Accurate detection: available() requires the exact AcpiTest_MULong class, so generic ACPI test classes no longer produce a false "hardware found". Writes now reach the EC instead of being silently accepted.
  • Administrator required for hardware control: run fan-daemon.exe from an elevated prompt, or install it as a SYSTEM startup task with scripts/install-service-windows.ps1.

Linux AppImage

fan-control-2.0.1-x86_64.AppImage bundles the full GTK4 + WebKitGTK 6 dashboard: CPython, PyGObject, GTK 4, WebKitGTK 6.0, and the built React UI. No system packages are needed beyond a recent glibc (built on Ubuntu 24.04).

chmod +x fan-control-2.0.1-x86_64.AppImage
./fan-control-2.0.1-x86_64.AppImage            # dashboard
./fan-control-2.0.1-x86_64.AppImage daemon     # daemon (run with sudo for EC access)
./fan-control-2.0.1-x86_64.AppImage ctl status --json

The dashboard is unprivileged; hardware control still requires the root daemon (AppImage daemon mode or the packaged fan-daemon).

Verification

SHA256SUMS.txt lists the SHA-256 digest of every attached asset. Source code archives are generated by GitHub for the tag.