GitHub - utajum/g-helper-linux

Click on the screenshot to view full size.

 ██████╗       ██╗  ██╗███████╗██╗     ██████╗ ███████╗██████╗ 
██╔════╝       ██║  ██║██╔════╝██║     ██╔══██╗██╔════╝██╔══██╗
██║  ███╗█████╗███████║█████╗  ██║     ██████╔╝█████╗  ██████╔╝
██║   ██║╚════╝██╔══██║██╔══╝  ██║     ██╔═══╝ ██╔══╝  ██╔══██╗
╚██████╔╝      ██║  ██║███████╗███████╗██║     ███████╗██║  ██║
 ╚═════╝       ╚═╝  ╚═╝╚══════╝╚══════╝╚═╝     ╚══════╝╚═╝  ╚═╝
                        ██╗     ██╗███╗   ██╗██╗   ██╗██╗  ██╗ 
                        ██║     ██║████╗  ██║██║   ██║╚██╗██╔╝ 
                        ██║     ██║██╔██╗ ██║██║   ██║ ╚███╔╝  
                        ██║     ██║██║╚██╗██║██║   ██║ ██╔██╗  
                        ███████╗██║██║ ╚████║╚██████╔╝██╔╝ ██╗ 
                        ╚══════╝╚═╝╚═╝  ╚═══╝ ╚═════╝ ╚═╝  ╚═╝ 
 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
         ╔══[ SYSTEM ]════════════════════════════════╗
         ║  >_ KERNEL: LINUX                          ║ 
         ║  >_ STATUS: ONLINE...                      ║
         ╚═══════════════════════════════[ 0x1F4 ]════╝
           ╔══════════════════════════════════════╗
           ║  ASUS LAPTOP CONTROL FOR LINUX       ║
            ╚══════════════════════════════════════╝

`░▒▓█ ╔══[ WEBSITE ]══╗ █▓▒░`

g-helper-linux.elevatech.xyz

`░▒▓█ ╔══[ MOTIVATION ]══╗ █▓▒░`

Since asusctl doesn't really care about Ubuntu, I decided to port most functionality from the original G-Helper for Windows.

The application is tested on KDE but other desktop environments should also work.

Pull requests and feature requests are welcome!

`░▒▓█ ╔══[ FEATURES ]══╗ █▓▒░`

┌──────────────────────────────────────────────────────────────────┐
│  Performance modes         Silent / Balanced / Turbo            │
│  Custom fan curves         8-point drag-to-edit per fan         │
│  Battery charge limit      Protect longevity (40-100%)          │
│  GPU mode switching        Eco / Standard / Optimized (MUX)     │
│  Power limits              CPU PL1/PL2, Dynamic Boost, temps    │
│  Screen control            Refresh rate, Panel OD, MiniLED      │
│  Keyboard backlight        Brightness + RGB color               │
│  Display                   Brightness, gamma adjustment         │
│  CPU boost                 Enable/disable turbo boost            │
│  System tray               Background tray icon + context menu  │
│  Auto-start                XDG autostart .desktop integration   │
└──────────────────────────────────────────────────────────────────┘

`░▒▓█ ╔══[ GPU MODE SWITCHING ]══╗ █▓▒░`

G-Helper manages the ASUS dGPU (discrete GPU) power state and MUX switch through four modes:

╔══[ MODES ]═════════════════════════════════════════════════════╗
║                                                                 ║
║  Eco         dGPU powered off (dgpu_disable=1)                 ║
║              Maximum battery life, iGPU only                    ║
║                                                                 ║
║  Standard    Hybrid mode (dgpu_disable=0, MUX=iGPU)            ║
║              dGPU available for offloading, iGPU drives display ║
║                                                                 ║
║  Optimized   Auto-switch based on power source                  ║
║              Eco on battery, Standard on AC power               ║
║                                                                 ║
║  Ultimate    dGPU direct (dgpu_disable=0, MUX=dGPU)            ║
║              Best performance — dGPU drives display directly    ║
║                                                                 ║
╚═════════════════════════════════════════════════════════════════╝

`╠══[ REBOOT REQUIREMENTS ]══╣`

Transition	Reboot?	Why
Eco ↔ Standard	Usually no	May need reboot if GPU driver is active
Any → Ultimate	Yes	MUX switch is latched, takes effect on reboot
Ultimate → Any	Yes	MUX switch back to iGPU requires reboot

When a reboot is required, G-Helper shows a notification and the pending mode appears in the UI. You can change your mind before rebooting — clicking a different mode cancels the pending change.

`╠══[ DRIVER BLOCKING DIALOG ]══╣`

Switching to Eco while the dGPU driver is active shows a dialog with three options:

Switch Now — attempts to unload the dGPU driver (requires admin password)
After Reboot — saves the mode for next boot (dGPU driver is blocked from loading via modprobe rules)
Cancel — keeps the current mode

`╠══[ KNOWN LIMITATIONS ]══╣`

Ultimate → Eco may require 2 reboots (MUX must change first, then Eco can apply)
MUX switch support varies by model — requires gpu_mux_mode sysfs attribute
Eco mode may require a reboot if the dGPU driver holds a DRM file descriptor
On boot, a systemd oneshot service applies pending GPU mode changes before the display manager starts

`░▒▓█ ╔══[ SYSTEM REQUIREMENTS ]══╗ █▓▒░`

╔══[ MINIMUM SPEC ]══════════════════════════════════════════════╗
║                                                                 ║
║  OS       Ubuntu 22.04+ / Debian 12+ / Fedora 38+ / Arch      ║
║  Desktop  X11 or Wayland (X11 recommended for full xrandr)     ║
║  Kernel   6.2+ recommended, 6.9+ for all features              ║
║  Module   asus-nb-wmi (loaded by default on ASUS laptops)      ║
║                                                                 ║
╚═════════════════════════════════════════════════════════════════╝

# verify kernel module
lsmod | grep asus
# expected: asus_nb_wmi, asus_wmi

`╠══[ KERNEL FEATURE MATRIX ]══╣`

Feature	Min Kernel
Performance modes, fan speed, battery limit	5.17
Custom fan curves (8-point)	5.17
PPT power limits (PL1, PL2, FPPT)	6.2
GPU MUX switch	6.1
NVIDIA Dynamic Boost / Temp Target	6.2
MiniLED mode control	6.9

`░▒▓█ ╔══[ INSTALLATION ]══╗ █▓▒░`

`╠══[ ONE-LINER INSTALL ]══╣`

curl -sL https://raw.githubusercontent.com/utajum/g-helper-linux/master/install/install.sh | sudo bash

`╠══[ MANUAL DOWNLOAD ]══╣`

curl -sL https://github.com/utajum/g-helper-linux/releases/latest/download/ghelper -o ghelper
chmod +x ghelper
./ghelper

`╠══[ APPIMAGE ]══╣`

curl -sL https://github.com/utajum/g-helper-linux/releases/latest/download/GHelper-x86_64.AppImage -o GHelper-x86_64.AppImage
chmod +x GHelper-x86_64.AppImage
./GHelper-x86_64.AppImage

`╠══[ BUILD FROM SOURCE ]══╣`

# Ubuntu/Debian
sudo apt install dotnet-sdk-8.0 clang zlib1g-dev

# Fedora
sudo dnf install dotnet-sdk-8.0 clang zlib-devel

# Arch
sudo pacman -S dotnet-sdk clang

./build.sh
sudo ./install/install-local.sh

╠══[ MANUAL BUILD COMMANDS ]══╣

# Development (JIT, fast iteration)
cd src && dotnet restore && dotnet run

# Production (Native AOT)
cd src && dotnet publish -c Release
# → src/bin/Release/net8.0/linux-x64/publish/ghelper

`░▒▓█ ╔══[ INSTALL TARGETS ]══╗ █▓▒░`

╔══[ DEPLOYED FILES ]════════════════════════════════════════════╗
║                                                                 ║
║  0xF0  Binary     /opt/ghelper/ghelper                         ║
║  0xF1  Symlink    /usr/local/bin/ghelper                       ║
║  0xF2  udev       /etc/udev/rules.d/90-ghelper.rules          ║
║  0xF3  Desktop    /usr/share/applications/ghelper.desktop      ║
║  0xF4  Autostart  ~/.config/autostart/ghelper.desktop          ║
║                                                                 ║
╚═════════════════════════════════════════════════════════════════╝

install.sh downloads the release binary. install-local.sh uses the local build from dist/.

# reload udev after install (or reboot)
sudo udevadm control --reload-rules && sudo udevadm trigger

╠══[ MANUAL SETUP ]══╣

# udev rules
sudo cp install/90-ghelper.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules && sudo udevadm trigger

# Desktop entry + autostart
sudo cp install/ghelper.desktop /usr/share/applications/
mkdir -p ~/.config/autostart
cp install/ghelper.desktop ~/.config/autostart/

`░▒▓█ ╔══[ CONFIGURATION ]══╗ █▓▒░`

~/.config/ghelper/config.json

Same JSON key format as Windows G-Helper — fan curves and mode settings are compatible.

`░▒▓█ ╔══[ PROJECT STRUCTURE ]══╗ █▓▒░`

g-helper-linux/
  build.sh                                # Build script (Native AOT)
  install/
    install.sh                            # Download + install (end users)
    install-local.sh                      # Install from local build (devs)
    90-ghelper.rules                      # udev rules
    ghelper.desktop                       # Desktop entry
  src/
    Program.cs                            # Entry point
    App.axaml / App.axaml.cs              # Avalonia app + tray icon
    GHelper.Linux.csproj                  # Project file (AOT config)
    Helpers/
      Logger.cs                           # Console logger
      AppConfig.cs                        # Configuration (JSON, AOT-safe)
    Mode/
      Modes.cs                            # Performance mode definitions
      ModeControl.cs                      # Mode change orchestrator
    Platform/
      Linux/
        SysfsHelper.cs                    # Core sysfs read/write utility
        LinuxAsusWmi.cs                   # asus-wmi sysfs + evdev events
        LinuxPowerManager.cs              # CPU boost, platform profile
        LinuxDisplayControl.cs            # Backlight, xrandr, gamma
        LinuxNvidiaGpuControl.cs          # nvidia-smi monitoring
        LinuxAmdGpuControl.cs             # amdgpu sysfs monitoring
        LinuxAudioControl.cs              # PulseAudio/PipeWire
        LinuxInputHandler.cs              # evdev event forwarding
        LinuxSystemIntegration.cs         # DMI sysfs, XDG autostart
    UI/
      Styles/
        GHelperTheme.axaml                # Dark theme
      Controls/
        FanCurveChart.cs                  # Interactive fan curve chart
      Views/
        MainWindow.axaml / .cs            # Main settings window
        FansWindow.axaml / .cs            # Fan curve editor + power limits
        ExtraWindow.axaml / .cs           # Display, power, system info
      Assets/
        *.png, *.ico                      # Image assets

`░▒▓█ ╔══[ ARCHITECTURE ]══╗ █▓▒░`

Windows (G-Helper)	Linux (this port)
`\\.\ATKACPI` DeviceIoControl	`/sys/devices/platform/asus-nb-wmi/` sysfs
DSTS (read) / DEVS (write)	`cat` / `echo >` sysfs attributes
WMI `Win32_*` queries	`/sys/class/dmi/id/` sysfs
`user32.dll` EnumDisplaySettings	`xrandr` CLI
NvAPIWrapper.Net	`nvidia-smi` CLI + hwmon sysfs
`atiadlxx.dll` (AMD ADL)	amdgpu hwmon sysfs
Task Scheduler autostart	XDG `~/.config/autostart/*.desktop`
WinForms UI	Avalonia UI (cross-platform)

`░▒▓█ ╔══[ CREDITS ]══╗ █▓▒░`

`░▒▓█ ╔══[ LICENSE ]══╗ █▓▒░`

Same license as the original G-Helper project.

  ░▒▓█ END OF TRANSMISSION █▓▒░
  > SESSION_END :: 0x00000000

Name		Name	Last commit message	Last commit date
Latest commit History 94 Commits
.github/workflows		.github/workflows
install		install
scripts		scripts
src		src
.gitignore		.gitignore
.upstream-last-checked		.upstream-last-checked
GHelper.Linux.sln		GHelper.Linux.sln
LICENSE		LICENSE
README.md		README.md
TODO.md		TODO.md
build-appimage.sh		build-appimage.sh
build.sh		build.sh
global.json		global.json
screenshot.png		screenshot.png

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

`░▒▓█ ╔══[ WEBSITE ]══╗ █▓▒░`

`░▒▓█ ╔══[ MOTIVATION ]══╗ █▓▒░`

`░▒▓█ ╔══[ FEATURES ]══╗ █▓▒░`

`░▒▓█ ╔══[ GPU MODE SWITCHING ]══╗ █▓▒░`

`╠══[ REBOOT REQUIREMENTS ]══╣`

`╠══[ DRIVER BLOCKING DIALOG ]══╣`

`╠══[ KNOWN LIMITATIONS ]══╣`

`░▒▓█ ╔══[ SYSTEM REQUIREMENTS ]══╗ █▓▒░`

`╠══[ KERNEL FEATURE MATRIX ]══╣`

`░▒▓█ ╔══[ INSTALLATION ]══╗ █▓▒░`

`╠══[ ONE-LINER INSTALL ]══╣`

`╠══[ MANUAL DOWNLOAD ]══╣`

`╠══[ APPIMAGE ]══╣`

`╠══[ BUILD FROM SOURCE ]══╣`

`░▒▓█ ╔══[ INSTALL TARGETS ]══╗ █▓▒░`

`░▒▓█ ╔══[ CONFIGURATION ]══╗ █▓▒░`

`░▒▓█ ╔══[ PROJECT STRUCTURE ]══╗ █▓▒░`

`░▒▓█ ╔══[ ARCHITECTURE ]══╗ █▓▒░`

`░▒▓█ ╔══[ CREDITS ]══╗ █▓▒░`

`░▒▓█ ╔══[ LICENSE ]══╗ █▓▒░`

About

Uh oh!

Releases 57

Packages

Uh oh!

Contributors 1

Languages

Folders and files

Latest commit

History

Repository files navigation

░▒▓█ ╔══[ WEBSITE ]══╗ █▓▒░

░▒▓█ ╔══[ MOTIVATION ]══╗ █▓▒░

░▒▓█ ╔══[ FEATURES ]══╗ █▓▒░

░▒▓█ ╔══[ GPU MODE SWITCHING ]══╗ █▓▒░

╠══[ REBOOT REQUIREMENTS ]══╣

╠══[ DRIVER BLOCKING DIALOG ]══╣

╠══[ KNOWN LIMITATIONS ]══╣

░▒▓█ ╔══[ SYSTEM REQUIREMENTS ]══╗ █▓▒░

╠══[ KERNEL FEATURE MATRIX ]══╣

░▒▓█ ╔══[ INSTALLATION ]══╗ █▓▒░

╠══[ ONE-LINER INSTALL ]══╣

╠══[ MANUAL DOWNLOAD ]══╣

╠══[ APPIMAGE ]══╣

╠══[ BUILD FROM SOURCE ]══╣

░▒▓█ ╔══[ INSTALL TARGETS ]══╗ █▓▒░

░▒▓█ ╔══[ CONFIGURATION ]══╗ █▓▒░

░▒▓█ ╔══[ PROJECT STRUCTURE ]══╗ █▓▒░

░▒▓█ ╔══[ ARCHITECTURE ]══╗ █▓▒░

░▒▓█ ╔══[ CREDITS ]══╗ █▓▒░

░▒▓█ ╔══[ LICENSE ]══╗ █▓▒░

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 57

Packages 0

Uh oh!

Contributors 1

Languages

`░▒▓█ ╔══[ WEBSITE ]══╗ █▓▒░`

`░▒▓█ ╔══[ MOTIVATION ]══╗ █▓▒░`

`░▒▓█ ╔══[ FEATURES ]══╗ █▓▒░`

`░▒▓█ ╔══[ GPU MODE SWITCHING ]══╗ █▓▒░`

`╠══[ REBOOT REQUIREMENTS ]══╣`

`╠══[ DRIVER BLOCKING DIALOG ]══╣`

`╠══[ KNOWN LIMITATIONS ]══╣`

`░▒▓█ ╔══[ SYSTEM REQUIREMENTS ]══╗ █▓▒░`

`╠══[ KERNEL FEATURE MATRIX ]══╣`

`░▒▓█ ╔══[ INSTALLATION ]══╗ █▓▒░`

`╠══[ ONE-LINER INSTALL ]══╣`

`╠══[ MANUAL DOWNLOAD ]══╣`

`╠══[ APPIMAGE ]══╣`

`╠══[ BUILD FROM SOURCE ]══╣`

`░▒▓█ ╔══[ INSTALL TARGETS ]══╗ █▓▒░`

`░▒▓█ ╔══[ CONFIGURATION ]══╗ █▓▒░`

`░▒▓█ ╔══[ PROJECT STRUCTURE ]══╗ █▓▒░`

`░▒▓█ ╔══[ ARCHITECTURE ]══╗ █▓▒░`

`░▒▓█ ╔══[ CREDITS ]══╗ █▓▒░`

`░▒▓█ ╔══[ LICENSE ]══╗ █▓▒░`

Packages