This tool provides fan control for HP/HyperX Omen Max, Victus and Omen laptops on Linux. It includes installer for a kernel driver patch (hp-wmi) to expose PWM controls and a userspace utility to manage fan curves, create watchdog that sets the fan configuration periodically and a simple stress test tool to see the fan curve in effect. It also allows periodically reversing the fan spin direction on supported boards to expel dust.
This tool includes a backported hp-wmi driver patch from the latest Linux kernel, which introduces native fan control support for many devices from the following models:
- Omen Max
- Victus
- Omen
This patch applies across Linux 5.15+ (including Ubuntu 22.04 LTS), all 6.x releases, and kernels 7.0–7.3.
Reference Kernel Commit: platform/x86: hp-wmi: add manual fan control for Victus S models
This program also includes a modification that sets the max speed according to calibration if the query to get the Max RPM fails for your device.
-
Models: HP OMEN MAX 16-ah0xxxnt (8D41), HP OMEN Transcend 16-u1xxx (8C4D), HP OMEN Transcend 16-u0xxx (8BB3), OMEN by HP Gaming Laptop 16-xf0xxx (8BCA), HP Victus 16 s1xxx (8C9C), HP Omen 15 ek1xxx (88C8), HP Omen 16-ap0000 (8E35), HP Victus 15-fb2xxx (8C2F), HP Omen 17 17z-db100 (8E10), HP OMEN Gaming Laptop 16-ap0xxx (8D24)
-
OS: Arch Linux 6.18, 6.19, 7.0, 7.1, 7.2; Ubuntu 24.04 (HWE 7.0), Fedora Linux 44 (7.3)
Would you like to add your model here? Create an issue with the "Tested Hardware" label and include these after successfully installing the patch and using the tool:
- Your laptop's board id (you can find it in /sys/class/dmi/id/board_name)
- Your kernel version (you can find it in /proc/version)
You must install kernel headers and build tools for the driver patch to compile and persist across kernel updates:
-
Arch Linux / CachyOS / Manjaro:
sudo pacman -S linux-headers base-devel dkms # Optional (for fan cleaner feature): sudo pacman -S acpi_call-dkms -
Debian / Ubuntu / Pop!_OS / Linux Mint:
sudo apt install linux-headers-$(uname -r) build-essential dkms # Optional (for fan cleaner feature, on supported OMEN MAX boards): sudo apt install acpi-call-dkms
Note:
linux-headers-$(uname -r)automatically pulls in all required common headers and build tools for your current kernel. If you prefer to track kernel updates via a metapackage, uselinux-headers-generic(Ubuntu/Mint/Pop!_OS) orlinux-headers-amd64(Debian). These dependency commands are continuously verified across containerized distributions viatests/test_distro_containers.py. -
Fedora / RHEL / Rocky Linux:
sudo dnf install kernel-devel-$(uname -r) kernel-headers gcc make dkms -
CachyOS / Clang Kernels: The Makefile detects if your kernel was built with Clang/LLVM and passes the correct
LLVM=1flags to the build system. No extra configuration is needed.
Choose one of the following: pipx/uv (recommended), Arch Linux packages, Debian packages, or clone + run from source.
Install the app in an isolated environment. Driver sources are bundled; you can run install-patch from the app.
Using uv:
uv tool install git+https://github.com/arfelious/omen-fan-control.git
sudo ln -sf "$HOME/.local/bin/omen-fan-control"* /usr/local/bin/
Using pipx:
pipx install git+https://github.com/arfelious/omen-fan-control.git
sudo ln -sf "$HOME/.local/bin/omen-fan-control"* /usr/local/bin/
After installation
sudo omen-fan-control status
# For calibration, driver installation, and fan control daemon installation.
sudo uv run omen-fan-control calibrate
sudo uv run omen-fan-control install-patch permanent
sudo uv run omen-fan-control service install
# For GUI
sudo omen-fan-control-guiNote: Because hardware fan control requires root permissions, symlinking the binaries to
/usr/local/binensuressudocan locate them.
Build and install from arch/omen-fan-control:
cd omen-fan-control/arch/omen-fan-control
makepkg -sf
sudo pacman -U omen-fan-control-*.pkg.tar.zstDriver sources are bundled with the app. After installation, calibrate and install the permanent patch (which configures DKMS with your calibrated values):
sudo omen-fan-control calibrate
sudo omen-fan-control install-patch permanent
sudo omen-fan-control service installBuild and install from deb/:
# Build package
cd omen-fan-control/deb
./build.sh
# Install package
sudo dpkg -i build/omen-fan-control_*.debDriver sources are bundled with the app. After installation, calibrate and install the permanent patch:
sudo omen-fan-control calibrate
sudo omen-fan-control install-patch permanent
sudo omen-fan-control service installgit clone https://github.com/arfelious/omen-fan-control.git
cd omen-fan-control
# With uv (recommended for source)
uv sync
sudo uv run omen-fan-control status
sudo uv run omen-fan-control calibrate
sudo uv run omen-fan-control install-patch permanent
sudo uv run omen-fan-control service install
sudo uv run omen-fan-control-gui
# With pip (editable install)
pip install -e .
sudo omen-fan-control status
# Or with pip + PYTHONPATH
pip install -r requirements.txt
export PYTHONPATH=src
sudo env PYTHONPATH=src python -m omen_fan_control.cli statusAfter installation, use omen-fan-control (CLI) and omen-fan-control-gui (GUI).
From a clone, replace with uv run omen-fan-control or PYTHONPATH=src python -m omen_fan_control.cli.
sudo omen-fan-control-guiGUI Fan Curve:
![]() |
|---|
Check Status:
sudo omen-fan-control statusSettings:
omen-fan-control settings --help
omen-fan-control settings
sudo omen-fan-control options --ma-window 10 --curve-interpolation smoothFan Control:
# Manual speed
sudo omen-fan-control fan-control --mode manual --value 80%
# Curve mode (requires service)
sudo omen-fan-control fan-control --mode curve
# Auto (default)
sudo omen-fan-control fan-control --mode auto
# Custom curve CSV (temp, percent per line)
sudo omen-fan-control fan-control --curve-csv my_curve.csvTemporary Settings (--no-save):
Use the --no-save flag to apply settings to the current session only. This prevents the utility from updating your persistent configuration file and is useful for one-off manual adjustments, hooks or scripts.
When using
--no-savein Manual or Auto modes, the utility will automatically stop the background service to prevent it from overwriting your temporary setting. However, in Curve mode, the service is kept running as it is required to process the temperature data and apply the fan curve.
sudo omen-fan-control fan-control --mode manual --value 100% --no-saveDetailed Information for Commands:
Commands provide detailed information when --help is passed with the command:
omen-fan-control fan-control --helpMost supported models do not report maximum fan RPM via BIOS queries. Running calibration first allows the utility to measure your hardware's actual fan limits and patch them into the driver source before building.
# 1. Calibrate fan speeds (or calibrate via GUI)
sudo omen-fan-control calibrate
# 2. Permanent Installation with DKMS (Recommended)
sudo omen-fan-control install-patch permanent
# Or temporary installation (until reboot)
sudo omen-fan-control install-patch temporarysudo omen-fan-control service installYou can also install it from the settings page in the graphical interface.
This is currently the only Linux utility capable of recreating the fan cleaning routine. On supported laptops, it reverses fan spin direction to dislodge accumulated dust. The cleaning interval, manual cleanup, and further configuration can be done using the Fan Cleaner page. The page is not visible on unsupported hardware to prevent unexpected behavior.
Fan cleaning feature requires the acpi_call module to be loaded:
sudo modprobe acpi_callIf you don't have the module installed:
Ubuntu / Debian / Pop!_OS:
sudo apt update
sudo apt install acpi-call-dkms
sudo modprobe acpi_callArch Linux / Manjaro / CachyOS:
sudo pacman -S acpi_call-dkms
sudo modprobe acpi_callPull requests, issues, and notifying about tested hardwares are welcome!
We are looking for testers. If you'd like to help, feel free to look at Issue #35
This utility is part of an ongoing effort to bring more OMEN Gaming Hub features to Linux. You might also want to check this project out:
Omen RGB Linux: RGB lighting controller that supports 4-zone, single-zone and per-key keyboards with GUI and SDK for OMEN/Victus laptops on Linux.
-
Remove Service:
sudo omen-fan-control service remove
-
Restore Driver:
sudo omen-fan-control install-patch restore
This restores the original
.kofiles from the backups created during installation. -
Uninstall Package & Symlinks:
- uv:
sudo rm -rf ~/.local/share/uv/tools/omen-fan-control ~/.local/bin/omen-fan-control* /usr/local/bin/omen-fan-control*
Note: Regular
uv tool uninstallwill likely fail with permission error as.pycfiles will be root-owned - pipx:
pipx uninstall omen-fan-control sudo rm -f /usr/local/bin/omen-fan-control* - Arch:
sudo pacman -R omen-fan-control - Debian:
sudo apt remove omen-fan-control
- uv:
USE AT YOUR OWN RISK.
Modifying kernel drivers and manipulating thermal control systems can potentially damage your hardware or cause instability. This software is provided "as is" without warranty of any kind. This was tested on my personal hardware, and the used hp-wmi.c is a patched and modified version of the one in the Linux kernel, so your mileage may vary.
Acknowledgements
Probes:
Linux 6.20 Kernel HP-WMI Driver:
RGB Support for 4-zone and single-zone keyboards:
