Initial release: z13Profiler GUI for unified memory on GZ302.

Adds zenity profile picker (gaming / LLM / reset) with safe RAM guardrails, pkexec-based apply, and install.sh for Nobara/Fedora. Co-authored-by: Cursor <[email protected]>
2026-06-24 23:30:48 -05:00
commit d5a7f9feeb
7 changed files with 724 additions and 0 deletions
@@ -0,0 +1,130 @@
+# z13Profiler
+
+GUI profile switcher for **ROG Flow Z13 (GZ302)** unified memory on **Nobara / Fedora**.
+
+Repository: [git.hisora.dev/Dawnsorrow/z13Profiler](https://git.hisora.dev/Dawnsorrow/z13Profiler)
+
+Switches between:
+
+| Profile | Fixed VRAM (carveout) | Dynamic GPU pool (TTM) |
+|---------|----------------------|-------------------------|
+| **Gaming** | 8 GB | Kernel default (removes custom TTM) |
+| **LLM / AI** | 512 MB (minimum available) | 48 GB |
+| **Reset** | 4 GB (ASUS default) | Kernel default |
+
+All changes require a **reboot**. The GUI warns and confirms before applying.
+
+## Quick install (Z13 / Nobara)
+
+```bash
+git clone https://git.hisora.dev/Dawnsorrow/z13Profiler.git
+cd z13Profiler
+./install.sh
+z13-memory-profiles
+```
+
+One-liner (clone + install):
+
+```bash
+git clone https://git.hisora.dev/Dawnsorrow/z13Profiler.git /tmp/z13Profiler && /tmp/z13Profiler/install.sh
+```
+
+Dependencies (install first if missing):
+
+```bash
+sudo dnf install -y git zenity python3 polkit
+```
+
+## Update from git
+
+If installed from this repo, pull and re-run the installer:
+
+```bash
+cd ~/z13Profiler   # or wherever you cloned
+git pull
+./install.sh
+```
+
+Or update the installed copy directly:
+
+```bash
+cd ~/.local/share/z13-memory-profiles
+git pull
+./install.sh
+```
+
+## Requirements
+
+- ROG Flow Z13 2025 (GZ302), 64 GB RAM (defaults in `config/profiles.conf`)
+- Nobara / Fedora with `zenity`, `python3`, `polkit` (`pkexec`)
+- Root via `pkexec` when applying profiles
+
+Optional: `pipx install amd-debug-tools` for standalone `amd-ttm` CLI.
+
+## Usage
+
+**GUI (Application menu → “Z13 Memory Profiles”, or terminal):**
+
+```bash
+z13-memory-profiles
+# alias after install:
+z13profiler
+```
+
+**Check current settings:**
+
+```bash
+z13-memory-profiles --status
+```
+
+**Apply from terminal (reboot manually after):**
+
+```bash
+sudo z13-memory-profiles --apply gaming
+sudo z13-memory-profiles --apply llm
+sudo z13-memory-profiles --apply reset
+```
+
+## Safeguards
+
+- Refuses profiles that would leave less than **8 GB** for the OS (configurable).
+- Warns if TTM exceeds **90%** of installed RAM.
+- Only writes `/etc/modprobe.d/ttm.conf` and UMA sysfs index (no random kernel hacks).
+- Uses `pkexec` for privileged operations from the GUI.
+
+## If fixed VRAM (carveout) does not change
+
+Some setups do not expose `/sys/class/drm/card0/device/uma/` yet. The tool still adjusts TTM for LLM mode. For gaming VRAM:
+
+1. Boot **Windows** once → **Armoury Crate → System Settings → Free up memory** → set **8 GB** → reboot.
+2. Or update Nobara/kernel and re-check `z13-memory-profiles --status`.
+
+## Customizing for your RAM size
+
+Edit `~/.local/share/z13-memory-profiles/config/profiles.conf` after install:
+
+```ini
+[llm]
+ttm_gb=48          # lower on 32 GB systems (e.g. 24)
+min_os_reserve_gb=8
+```
+
+## Uninstall
+
+```bash
+rm -f ~/.local/bin/z13-memory-profiles ~/.local/bin/z13profiler
+rm -rf ~/.local/share/z13-memory-profiles
+rm -f ~/.local/share/applications/z13-memory-profiles.desktop
+sudo rm -f /etc/modprobe.d/ttm.conf
+sudo dracut --force --regenerate-all 2>/dev/null || true
+```
+
+Then reboot.
+
+## Build tarball (optional)
+
+```bash
+./package.sh
+```
+
+Creates `z13Profiler-1.0.0.tar.gz` in the parent directory for USB transfer.