G-Linux

Native ASUS ROG laptop controls for Linux and KDE Plasma.

G-Linux is an early-stage native alternative to Armoury Crate and G-Helper for ASUS laptops. It combines a compact Qt 6/Kirigami interface with the installed asusd service, standard Linux hardware interfaces and Plasma desktop APIs. Controls are created from live capabilities, so each laptop exposes only the features its firmware and drivers actually provide.

The current release has been developed and exercised on an ASUS ROG Flow X16 GV601VV. Support for other models is expected to grow from live hardware reports and tested device contributions.

Features

Area	Available controls
Performance	Silent, Balanced, Turbo and Custom modes; Power Profiles synchronization; EPP; AC/battery profile automation.
Fans and power	Detected CPU, GPU and auxiliary eight-point fan curves; live CPU/APU/platform/NVIDIA firmware limits.
GPU	Standard, Eco and Ultimate modes derived from live dgpu_disable and MUX attributes. Restart-required transitions are verified and followed by an immediate system restart.
Battery	Charge limit, one-time full charge, health, charge state and live power draw.
Keyboard lighting	Firmware-reported Aura effects, colors, speed, direction, zones, brightness and power states.
Display	Low refresh, maximum refresh with Panel Overdrive, automatic battery/AC switching and Adaptive Sync.
GameVisual	ASUS gamut and GameVisual profiles selected by an exact laptop, GPU vendor and panel EDID match.
ASUS hardware	Mini-LED, AniMe Matrix, Slash Lighting, boot sound, XG Mobile/eGPU and reserved iGPU memory when exposed by the active backend.
NVIDIA tuning	Core and memory offsets validated against the installed driver and applied through a narrowly scoped KAuth helper.
Desktop integration	Plasma tray item, media-key assignments, D-Bus activation, autostart, diagnostics and rotating logs.

Hardware support

G-Linux does not use a model name as proof that a feature exists. Support is resolved from the current asusd ObjectManager snapshot, kernel interfaces, KScreen and driver metadata. Exact device data is used only where a resource must match the physical panel, such as ASUS ICC and GameVisual profiles.

The following paths have been checked on the Flow X16 GV601VV: performance profiles, EPP, charge control, three fan curves, firmware power limits, Aura including Color Cycle, keyboard brightness, refresh switching, Panel Overdrive, GameVisual, telemetry, hotkeys and diagnostics.

Current scope:

• Optimized GPU policy is not exposed until Linux-side external-display and active-GPU workload checks are complete.
• P-core/E-core controls remain unavailable until the Linux ABI offers a validated paired operation.
• Reactive Aura effects and writable external-peripheral controls need backend APIs that are not currently provided by asusd.
• Full live validation has so far been completed only on GV601VV.

Install on Arch Linux

Install and start asusctl/asusd, then build the native package from the repository root:

makepkg -si -D packaging/arch
sudo systemctl enable --now asusd.service
sudo systemctl enable --now power-profiles-daemon.service

The package installs the application, desktop entry, icon, D-Bus activation service and NVIDIA KAuth helper. Start G-Linux from the application launcher or run g-linux.

Build from source

Arch Linux dependencies:

sudo pacman -S --needed base-devel cmake ninja extra-cmake-modules \
  qt6-base qt6-declarative qt6-svg kirigami karchive kauth kdbusaddons \
  kglobalaccel kscreen kstatusnotifieritem lcms2 libxnvctrl

Configure, build and test:

cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=RelWithDebInfo
cmake --build build --parallel
ctest --test-dir build --output-on-failure

Create a production build and install it:

cmake -S . -B build-release -G Ninja \
  -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTING=OFF
cmake --build build-release --parallel
sudo cmake --install build-release

7zip is optional and used for ASUS color-profile extraction. nvidia-utils is optional and required for NVML clock control.

Diagnostics

Run a read-only hardware report with:

g-linux --diagnostics

Logs are stored under the XDG state directory, normally ~/.local/state/G-Linux/GLinux/g-linux.log.

Documentation

• Architecture
• Code map
• Hardware integration
• Testing

License

G-Linux is licensed under the GNU General Public License v3.0 or later.

G-Linux is an independent project and is not affiliated with or endorsed by ASUSTeK Computer Inc. ASUS, ROG and Armoury Crate are trademarks of their respective owners.