G-Helper for Linux 🐧

A lightweight, native Linux port of the popular G-Helper tool for ASUS ROG/TUF laptops.

This application provides a clean, familiar UI to control your laptop's performance, display, and lighting settings on Linux, replacing the need for multiple CLI tools or complex scripts.

✨ Features

• Performance Modes: Toggle Silent / Balanced / Turbo profiles (integrated with asusctl).
• GPU Handling: optimized GPU switching (Eco / Standard / Ultimate / VFIO) via supergfxctl.
• Screen Control:
  • Change Refresh Rates (60Hz / Max / Auto).
  • Flicker-Free Dimming / Screen Brightness.
• Keyboard & Lighting:
  • Laptop Keyboard: Adjust Backlight Brightness (Off/Low/Med/High).
  • Aura Control: Set Static, Breathe, Cycle, or Strobe effects with custom colors and speed.
  • Slash Lighting: Control ROG Flow Z13/G14 Slash Lighting (Toggle on/off, change colors).
• Battery Health: Set battery charge limit to extend lifespan.
• Monitoring: Real-time display of CPU/GPU temperatures and fan speeds.

⚠️ Requirements

This application relies on the excellent work of the Asus-Linux community. You must have the following installed and running:

1. Kernel: Linux kernel 6.1+ (recommended 6.5+ for comprehensive hardware support).
2. Tools:
   • asusctl: For system controls, profiles, and keyboard/aura.
   • supergfxctl: For GPU switching.
3. Desktop Environment: Works best on Wayland (KDE Plasma/GNOME) but supports X11.

🚀 Installation

Building from Source

You can build the application using the provided Docker script (recommended for compatibility) or directly with .NET SDK.

Option 1: Docker Build (Recommended)

This approach ensures you build against a consistent environment without installing .NET SDK on your host.

# Clone the repository
git clone https://github.com/th3cavalry/g-helper-linux.git
cd g-helper-linux

# Build using Docker script
./build-docker.sh

The resulting binary will be placed in ./build_out/GHelper.Linux.

Option 2: Manual Build

Requires .NET 8.0 SDK (or newer) installed.

dotnet publish GHelper.Linux/GHelper.Linux.csproj -c Release -r linux-x64 --self-contained true -o ./publish

Running

To control hardware settings (backligt, fan curves, battery limit), the app typically requires permissions to access system interfaces.

# Run the built binary
sudo ./build_out/GHelper.Linux

⌨️ Usage

• Performance Buttons: Click "Silent", "Balanced", or "Turbo" to switch profiles.
• GPU Mode: Select "Eco" (iGPU Only), "Standard" (Hybrid), or "Ultimate" (dGPU Only). Note: GPU switching may require a session logout/login.
• Keyboard: Use the buttons to toggle brightness or change Aura effects.
• Slash Lighting: If supported (e.g., Z13), controls will appear automatically.

🤝 Credits

• Seerge for the original G-Helper (Windows) and design inspiration.
• [LukeJones](https://gitlab.com/lux flow) and the Asus-Linux team for asusctl, supergfxctl, and kernel patches that make this possible.