Linux optimization suite for the ASUS ROG Flow Z13 (GZ302) powered by the AMD Ryzen AI MAX+ 395 (Strix Halo) processor.
Hardware fixes, power/TDP management, RGB lighting, fan curves, battery limiting, and a system tray GUI — powered by z13ctl.
One script handles everything. Pick which sections to install interactively:
curl -L https://raw.githubusercontent.com/th3cavalry/GZ302-Linux-Setup/main/gz302-setup.sh -o gz302-setup.sh
chmod +x gz302-setup.sh
sudo ./gz302-setup.shThe installer prompts for four sections:
| Section | What it does |
|---|---|
| 1. Hardware Fixes | WiFi (MT7925), GPU (Radeon 8060S), Input, Audio (SOF/CS35L41), OLED PSR-SU fix, Suspend fix |
| 2. z13ctl | RGB lighting, power profiles, TDP, fan curves, battery charge limit, undervolt, sleep recovery |
| 3. Display & Tools | Refresh rate control (rrcfg), system tray app |
| 4. Optional Modules | Gaming (Steam, Lutris, MangoHUD), AI/LLM (Ollama, ROCm), Hypervisor (KVM/QEMU) |
sudo ./gz302-setup.sh -y # Accept all defaults (non-interactive)
sudo ./gz302-setup.sh --fixes-only # Hardware fixes only
sudo ./gz302-setup.sh --no-z13ctl # Skip z13ctl installation
sudo ./gz302-setup.sh --help # Show all options# RGB lighting
z13ctl apply --color cyan --brightness high
z13ctl apply --mode rainbow --speed normal
z13ctl off
# Power profiles
z13ctl profile --set balanced
z13ctl tdp --set 50
# Battery
z13ctl batterylimit --set 80
# Fan curves (8-point, temp:pwm pairs)
z13ctl fancurve --set "48:2,53:22,57:30,60:43,63:56,65:68,70:89,76:102"
# Status
z13ctl statusThe installer creates pwrcfg and gz302-rgb wrappers that map to z13ctl:
| Command | Maps to |
|---|---|
pwrcfg balanced |
z13ctl profile --set balanced |
pwrcfg tdp --set 50 |
z13ctl tdp --set 50 |
gz302-rgb static red |
z13ctl apply --mode static --color red |
gz302-rgb rainbow |
z13ctl apply --mode rainbow |
After installation, look for "ASUS ROG Flow Z13 (GZ302) Command Center" in your system tray.
- Right-click: Quick profile switching (Quiet, Balanced, Performance)
- Middle-click: Toggle RGB on/off
- Hover: Real-time power and battery status
The scripts automatically detect your kernel and adapt:
| Kernel | Status |
|---|---|
| < 6.14 | Unsupported — please upgrade |
| 6.14 – 6.16 | Applies workarounds for WiFi (MT7925), Touchpad, Tablet mode |
| 6.17+ | Native support — cleans up obsolete fixes, focuses on tuning |
Issue: Purple/green color artifacts during scrolling, intermittent corruption during idle, or color-shift fringing on the built-in OLED panel (not external monitors).
Cause: Multiple DC power-save features active on the internal eDP panel: PSR, PSR-SU, Panel Replay (DCN 3.5 / Strix Halo), IPS (Idle Power Save), DRAM stutter, and scatter-gather display on APU. ABM (Adaptive Backlight Management) also causes colour-shift artifacts on OLED.
Fix: amdgpu.dcdebugmask=0xe12 + modprobe options abmlevel=0 and sg_display=0 — applied automatically by the installer.
GZ302-Linux-Setup/
├── gz302-setup.sh # Unified installer (single entry point)
├── gz302-lib/ # Core libraries (manager-based)
│ ├── utils.sh # Shared utilities, logging, backups
│ ├── kernel-compat.sh # Kernel version detection
│ └── ... (wifi, gpu, audio, etc.)
├── modules/ # Optional feature packs (gaming, llm, etc.)
├── scripts/ # System scripts (fix-suspend, uninstall)
├── tray-icon/ # PyQt6 system tray application
├── docs/ # User guides and changelogs
│ └── technical/ # Hardware research and obsolescence analysis
└── legacy/ # Deprecated and replaced scripts
MANDATORY for all AI/LLM interactions and automated code changes. All AI agents MUST read and follow the strict mandates in .github/copilot-instructions.md.
- z13ctl by Jeff Hagadorn — RGB lighting, power profiles, TDP, fan curves, battery limit, and daemon. The hardware control backend that makes this all possible.
- g-helper by seerge — Protocol reverse-engineering reference for ASUS HID devices.
- Strix-Halo-Control by TechnoDaimon — GTK4 GUI inspiration for z13ctl integration.
sudo bash scripts/uninstall/gz302-uninstall.shThis removes all GZ302 tools, z13ctl daemon/config, systemd services, udev rules, and configuration files.
- Documentation: See the docs/ directory for user guides and docs/technical/ for hardware research.
- AI Guidelines: Strict rules for LLM/Copilot contributions are in .github/copilot-instructions.md.
- Issues: Report bugs on the Issues page.
- Development: See CONTRIBUTING.md.
License: MIT Maintained by: th3cavalry