Skip to content

About

HP/HyperX Omen Max, Omen & Victus Fan Control CLI & GUI tool for Linux thermal management. Implements hp-wmi patches to allow configurable fan controls.

Topics

Resources

Stars

60 stars

Watchers

3 watching

Forks

Latest commit

 

History

109 Commits

Folders and files

Repository files navigation

HP Omen Fan Control (Linux)

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.

Context

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:

  1. Omen Max
  2. Victus
  3. 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.

Tested Hardware

  • 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)

Installation

System Dependencies

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, use linux-headers-generic (Ubuntu/Mint/Pop!_OS) or linux-headers-amd64 (Debian). These dependency commands are continuously verified across containerized distributions via tests/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=1 flags to the build system. No extra configuration is needed.


Choose an Installation Method

Choose one of the following: pipx/uv (recommended), Arch Linux packages, Debian packages, or clone + run from source.

Option A: uv or pipx (recommended)

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-gui

Note: Because hardware fan control requires root permissions, symlinking the binaries to /usr/local/bin ensures sudo can locate them.

Option B: Arch Linux (PKGBUILD)

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.zst

Driver 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 install

Option C: Debian / Ubuntu (deb)

Build and install from deb/:

# Build package
cd omen-fan-control/deb
./build.sh

# Install package
sudo dpkg -i build/omen-fan-control_*.deb

Driver 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 install

Option D: Clone and run from source

git 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 status

Usage

After 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.

GUI

sudo omen-fan-control-gui

GUI Fan Curve:

Omen Fan Control GUI

CLI

Check Status:

sudo omen-fan-control status

Settings:

omen-fan-control settings --help
omen-fan-control settings
sudo omen-fan-control options --ma-window 10 --curve-interpolation smooth

Fan 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.csv

Temporary 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-save in 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-save

Detailed Information for Commands: Commands provide detailed information when --help is passed with the command:

omen-fan-control fan-control --help

Calibrate & Install Driver Patch

Most 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 temporary

Install Background Service

sudo omen-fan-control service install

You can also install it from the settings page in the graphical interface.

Fan Cleaning

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_call

If you don't have the module installed:

Ubuntu / Debian / Pop!_OS:

sudo apt update
sudo apt install acpi-call-dkms
sudo modprobe acpi_call

Arch Linux / Manjaro / CachyOS:

sudo pacman -S acpi_call-dkms
sudo modprobe acpi_call

Contributing

Pull 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

Related Projects

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.

Uninstallation

  1. Remove Service:

    sudo omen-fan-control service remove
  2. Restore Driver:

    sudo omen-fan-control install-patch restore

    This restores the original .ko files from the backups created during installation.

  3. 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 uninstall will likely fail with permission error as .pyc files 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

Disclaimer

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:

About

HP/HyperX Omen Max, Omen & Victus Fan Control CLI & GUI tool for Linux thermal management. Implements hp-wmi patches to allow configurable fan controls.

Topics

Resources

Stars

60 stars

Watchers

3 watching

Forks

Releases

Packages

Contributors

Languages