Skip to content

Latest commit

 

History

History
71 lines (50 loc) · 2.17 KB

File metadata and controls

71 lines (50 loc) · 2.17 KB

Victus Control GNOME Shell Extension

A GNOME Shell extension for controlling HP Victus / Omen fan modes and keyboard lighting directly from the top panel.

Features

  • 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

Requirements

  • victus-control backend: This extension requires the victus-backend.service to be running
  • GNOME Shell: Version 45 or later
  • HP Victus / Omen laptop: The patched hp_wmi driver must be installed

Support Scope

  • Fully integrated with the main victus-control installer 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.

Installation

  1. Ensure victus-control is installed and the backend service is running:

    sudo systemctl status victus-backend.service
  2. Install the extension:

    cd gnome-extension
    bash ./install.sh
  3. Enable the extension:

    gnome-extensions enable victus-control@victus

    Or use the GNOME Extensions app.

Usage

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.

Development

To test changes without restarting GNOME Shell:

  1. Save your changes
  2. 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 victus

License

GPLv3 - See the main LICENSE file.