🚀 GZ302 Linux Toolkit

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.

---

📥 Installation

❓ Which script should I use?

Feature	1. Command Center	2. Full Setup	3. Minimal
Best For	Existing Users / Power Users	Fresh Installations	Purists / Servers
Hardware Fixes	❌ (Assumes native/fixed)	✅ (Kernel-aware)	✅ (Kernel-aware)
Power/Fan Control	✅	✅	❌
RGB Control	✅	✅	❌
GUI / Tray App	✅	✅	❌
Optional Modules	❌	✅	❌

---

1. Command Center Installer (Recommended)

Installs: 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.sh

2. Full Setup (Fresh Install)

Installs: Everything in Command Center PLUS essential hardware fixes (WiFi, GPU, Input) tailored to your kernel version.

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.sh

3. Minimal Setup (Fixes Only)

Installs: 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.sh

---

🎛️ Features & Usage

🖥️ Command Center GUI

After 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.

⌨️ CLI Tools

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.

---

🧩 Optional Modules

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.

---

⚠️ Kernel Compatibility

The scripts automatically detect your kernel and adapt the strategy:

• Kernel < 6.14: ❌ Unsupported. Please upgrade.
• Kernel 6.14 - 6.16: ✅ Essential. Applies heavy patching for WiFi (MT7925), Touchpad, and Tablet mode.
• Kernel 6.17+: ✨ Native Mode. Most hardware works out of the box. The script cleans up obsolete fixes and focuses on performance tuning.

---

📂 Repository Structure

The project uses a Library-First Architecture for stability and modularity.

GZ302-Linux-Setup/
├── gz302-main.sh              # 🟢 Entry Point: Full Setup
├── install-command-center.sh  # 🟢 Entry Point: Tools Only
├── gz302-minimal.sh           # 🟢 Entry Point: Minimal Fixes
├── modules/                   # 📦 Optional feature packs (Gaming, AI, etc.)
├── scripts/                   # 🛠️ Standalone binaries & helpers (RGB, Restore)
├── gz302-lib/                 # 📚 Shared core libraries (Power, Display, Utils)
├── tray-icon/                 # 🖼️ Python/Qt6 GUI Application
└── docs/                      # 📄 Documentation & hardware research

---

🤝 Contributing & Support

• 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