DEV Community

Cover image for Boreas: open-source control panel for ASUS ROG/TUF laptops on Linux, looking for testers and contributors
yusuf yonturk
yusuf yonturk

Posted on

Boreas: open-source control panel for ASUS ROG/TUF laptops on Linux, looking for testers and contributors

Boreas is a control panel for ASUS ROG and TUF laptops on Linux. I develop it on one machine, a ROG Strix G713PV, and it now needs reports from other models and people to work on the code.

Hardware support comes from the asus-linux.org project's kernel drivers (asus-wmi, asus-armoury). Boreas provides the userspace: the service, the tray app and the CLI.

How to help:

Test it: install, run boreasctl status, and open an issue with the output and uname -r. "Everything works" is a useful report too.

Unsure about your model? Post the model code (e.g. H7604JI) and I will check kernel support before you install.

Code: Python and Qt. The tests use a simulated sysfs tree, so you do not need an ASUS laptop. What is open:

Missing features: Ryzen undervolt (Curve Optimizer), GPU clock offsets, one-time charge to 100 %, ROG/M4 key binding, Aura second color and sleep/shutdown lighting

Other desktops: refresh-rate switching only works on KDE today; GNOME, Hyprland and others are open

Other hardware: Intel models, TUF, AniMe Matrix and Slash displays, ASUS mice and headsets

Packaging: AUR, Fedora COPR, Nix. Right now it is git clone and 'install.sh'

A Cardwire backend over D-Bus for the no-reboot Eco path

Translations: 11 languages, corrections welcome.

What it does: performance modes, fan curves, CPU power limits, GPU modes with the MUX switch, Aura, charge limit and refresh rate. Each mode keeps its own fans, power limits and CPU temperature target, and Fn+F5 switches all of them together. The temperature target works per mode: set 75 to 95 °C and Boreas adjusts the power limits to stay near it.

Good to know:

It is written from scratch in Python. The layout resembles G-Helper on purpose, but no G-Helper source is copied; the two places where it served as a reference are listed in THIRD_PARTY_NOTICES.md.

It replaces asusctl (asusd, supergfxd) and cannot run next to it. The installer masks those services; the uninstaller restores them. For AniMe Matrix or Slash, asusctl is still the tool to use.

Eco without a reboot works through an optional eBPF backend built on Cardwire. It is experimental and off by default.

GPL-3.0: https://github.com/Yusuf-Yonturk/boreas

Top comments (0)