A GNOME Shell extension for controlling HP Victus / Omen fan modes and keyboard lighting directly from the top panel.
- Fan Mode Control: Switch between AUTO, Better Auto, MANUAL, and MAX modes
- Manual Fan Speed: Per-fan speed control with 8 RPM steps (when in MANUAL mode)
- Keyboard RGB: Color presets and brightness control
- Live Status: Real-time CPU temperature and fan RPM display
- victus-control backend: This extension requires the
victus-backend.serviceto be running - GNOME Shell: Version 45 or later
- HP Victus / Omen laptop: The patched
hp_wmidriver must be installed
- Fully integrated with the main
victus-controlinstaller on Fedora and Arch-based systems. - Should also work on Ubuntu GNOME and other GNOME desktops if the backend service is already installed and exposing
/run/victus-control/victus_backend.sock.
-
Ensure victus-control is installed and the backend service is running:
sudo systemctl status victus-backend.service
-
Install the extension:
cd gnome-extension bash ./install.sh -
Enable the extension:
gnome-extensions enable victus-control@victusOr use the GNOME Extensions app.
Click on the fan icon (🌀) in the top panel to access:
- Fan Mode: Select operating mode from the dropdown
- Fan Speed Sliders: Adjust individual fan speeds (visible in MANUAL mode only)
- Keyboard RGB: Choose color presets and adjust brightness
- Status: View current CPU temperature and fan RPM
When the main project is installed via sudo ./install.sh on a GNOME desktop, this extension is installed automatically for the desktop user.
To test changes without restarting GNOME Shell:
- Save your changes
- Disable and re-enable the extension:
gnome-extensions disable victus-control@victus gnome-extensions enable victus-control@victus
View extension logs:
journalctl -f -o cat /usr/bin/gnome-shell | grep --line-buffered -i victusGPLv3 - See the main LICENSE file.