Skip to content

Repository files navigation

OmenHub

A GTK4 fan control and keyboard backlight manager for HP Omen/Victus laptops on Arch Linux.

License Platform

Features

  • Smart Fan Control - Intelligent auto mode that dynamically adjusts fan speeds based on CPU/GPU temperature and utilization
  • Manual RPM Control - Fine-grained control with 8 RPM steps per fan (~2000 → 5800/6100 RPM)
  • Keyboard RGB Lighting - Control single-zone RGB colour and brightness
  • Background Service - Persistent fan management that works even without the GUI open
  • Modern GTK4 Interface - Clean, native Linux desktop experience

Screenshots

<--help Add screenshots here -->

Requirements

  • Arch Linux (or Arch-based distro)
  • HP Omen or Victus laptop with supported hardware
  • systemd

Dependencies are installed automatically by the install script.

Installation

git clone https://github.com/Vetri1706/OmenHub-Mock-for-ArchLinux-.git
cd OmenHub-Mock-for-ArchLinux-
sudo ./install.sh

Log out and back in after installation to apply group permissions.

Usage

GUI Application

Launch OmenHub from your application menu or run:

victus-control

Fan Modes

Mode Description
AUTO Stock HP firmware control
Better Auto Smart dynamic control based on temps/load
Manual Direct RPM control via sliders
MAX Maximum fan speed

Service Management

# Check status
systemctl status victus-backend.service

# View logs
journalctl -u victus-backend -f

Building from Source

meson setup build --prefix=/usr
meson compile -C build
sudo meson install -C build

Troubleshooting

Issue Solution
Fans not responding Check DKMS module: dkms status | grep hp-wmi
Permission denied Verify group membership: groups $USER
Socket not found Run: sudo systemd-tmpfiles --create

Uninstall

sudo systemctl disable --now victus-backend
sudo dkms remove hp-wmi-fan-and-backlight-control/0.0.2 --all

Contributing

Pull requests are welcome! Please test on your hardware and include device model info in your PR.

Author

Vetri1706

License

This project is licensed under the GPLv3 License - see the LICENSE file for details.

Acknowledgments

  • Based on the hp-wmi kernel module patches for fan control
  • GTK4 for the modern UI framework

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages