The ultimate Linux optimization suite for the ASUS ROG Flow Z13 (GZ302). Transform your device into a powerhouse with kernel-aware hardware fixes, intelligent power management, and a dedicated Command Center.
| Feature | 1. Full Setup | 2. Command Center | 3. Minimal |
|---|---|---|---|
| Best For | Fresh Installations | Existing Users / Power Users | Purists / Servers |
| Hardware Fixes | ✅ (Modular) | ❌ (Assumes native/fixed) | ✅ (Kernel-aware) |
| Power/Fan Control | ✅ | ✅ | ❌ |
| RGB Control | ✅ | ✅ | ❌ |
| GUI / Tray App | ✅ | ✅ | ❌ |
| Optional Modules | ✅ | ❌ | ❌ |
Installs: Essential hardware fixes (WiFi, GPU, Input) and the complete Command Center toolset. Now refactored for maximum efficiency.
curl -L https://raw.githubusercontent.com/th3cavalry/GZ302-Linux-Setup/main/gz302-main.sh -o gz302-main.sh
chmod +x gz302-main.sh
sudo ./gz302-main.shInstalls: Power profiles, Fan curves, RGB control, Refresh rate manager, and the System Tray App. Does NOT touch kernel parameters or hardware drivers.
curl -L https://raw.githubusercontent.com/th3cavalry/GZ302-Linux-Setup/main/install-command-center.sh -o install-command-center.sh
chmod +x install-command-center.sh
sudo ./install-command-center.shInstalls: Only the bare minimum kernel patches and configuration files to make the hardware function. No extra tools.
curl -L https://raw.githubusercontent.com/th3cavalry/GZ302-Linux-Setup/main/gz302-minimal.sh -o gz302-minimal.sh
chmod +x gz302-minimal.sh
sudo ./gz302-minimal.shAfter installation, look for "GZ302 Command Center" in your application menu or system tray.
- Right-click: Quick profile switching (Silent, Balanced, Turbo).
- Middle-click: Toggle RGB on/off.
- Hover: See real-time power draw and battery health.
Control your device entirely from the terminal.
| Command | Usage | Description |
|---|---|---|
pwrcfg |
pwrcfg gaming |
Switch power/fan profiles (silent, balanced, gaming, max) |
rrcfg |
rrcfg 120 |
Set refresh rate (30, 60, 120, 144, 165) or VRR mode |
gz302-rgb |
gz302-rgb static ff0000 |
Control Keyboard and Rear Window RGB lighting |
Note: RGB settings persist across reboots automatically.
The Full Setup script includes an optional module manager:
- 🎮 Gaming: Installs Steam, Lutris, MangoHUD, GameMode, and optimized Wine builds.
- 🤖 AI / LLM: Sets up a local AI stack (Ollama, LM Studio, ROCm) optimized for the Strix Halo NPU/GPU.
- 💻 Hypervisor: Configures KVM/QEMU for maximum performance VM passthrough.
The scripts automatically detect your kernel and adapt the strategy:
- Kernel < 6.14: ❌ Unsupported. Please upgrade.
- Kernel 6.14 - 6.16: ✅ Legacy Mode. Applies essential workarounds for WiFi (MT7925), Touchpad, and Tablet mode.
- Kernel 6.17+: ✨ Native Mode. Most hardware works out of the box. The toolkit cleans up obsolete fixes and focuses on performance tuning.
The project uses a Modular Library-First Architecture for stability and maintainability.
GZ302-Linux-Setup/
├── gz302-main.sh # 🟢 Entry Point: Full Setup (Orchestrator)
├── install-command-center.sh # 🟢 Entry Point: Tools Only
├── gz302-minimal.sh # 🟢 Entry Point: Minimal Fixes
├── gz302-lib/ # 📚 Refactored Core Libraries (Manager-based)
│ ├── distro-manager.sh # 🚀 NEW: Distribution setup orchestrator
│ ├── power-manager.sh # ⚡ TDP & Battery management
│ ├── gpu-manager.sh # 🎮 GPU & KMS configuration
│ └── ... # (Audio, WiFi, Input, RGB, etc.)
├── modules/ # 📦 Optional feature packs (Gaming, AI, etc.)
└── tray-icon/ # 🖼️ Python/Qt6 GUI Application
- Documentation: Check the docs/ directory for detailed hardware research.
- Issues: Please report bugs on the Issues page.
- Development: See CONTRIBUTING.md to get started.
License: MIT
Maintained by: th3cavalry