Skip to content
 
 

Repository files navigation

Z13GUI+

GTK4 overlay drawer for z13ctl-plus on Wayland.

License

Z13GUI+

Z13GUI+ is an independently named fork of dahui/z13gui for z13ctl-plus. It preserves intentional API and UI compatibility, but v2.0.0 uses its own command, service, configuration, runtime, desktop, and application-ID namespaces. The installed command is z13gui-plus; no z13gui alias is provided.

The z13gui-plus package can coexist with upstream. Packages do not provide, conflict with, or replace upstream, and installation leaves the GUI service disabled. Enable only the GUI that matches the controller daemon you selected.

What Plus Adds

  • Power automation — save named configurations and assign separate presets for plugged-in and battery operation
  • Independent CPU policy — control minimum CPU frequency, AMD EPP, and boost without coupling them to GPU clocks
  • Expanded telemetry — monitor CPU, GPU, NPU, memory, battery, power, clocks, temperatures, and both fans from a dedicated Overview
  • Battery insight — see health, energy capacity, system draw, charge state, and direction-aware runtime estimates
  • Direct display control — switch the internal panel between 60 Hz and 180 Hz
  • Safer tuning feedback — identify unsaved overrides, high-TDP fan safety, the live fan-curve operating point, and reset all tuning overrides together
  • Faster fan control — select Auto, Balanced, or Turbo without editing a curve

Related projects

Z13GUI+ is part of a three-repo tablet stack for the Z13:

  • z13ctl-plus — the daemon behind this drawer: owns display state and persists tablet settings
  • z13-tablet-kit — posture detection (dock/folio/tablet) and touch input: touchscreen toggling, touch scrolling, and two-finger context menus

The tablet chip in this drawer is hidden until the kit's z13-tablet-switch reports a heartbeat. Toggles you change here are persisted by z13ctl-plus and applied live by the kit — no restarts required.

Interface

Power
Z13GUI+ Power tab
Power Tuning
Z13GUI+ Power Tuning view
RGB
Z13GUI+ RGB tab
System
Z13GUI+ System tab

Install

# Arch Linux (AUR)
yay -S z13gui-plus-bin

# Debian / Ubuntu
sudo apt install ./z13gui-plus_*.deb

# Fedora / RHEL
sudo dnf install ./z13gui-plus_*.rpm

# Manual (from release tarball)
wget https://github.com/aic0d3r/z13gui-plus/releases/download/v2.1.0/z13gui-plus_2.1.0_linux_amd64.tar.gz
tar xzf z13gui-plus_2.1.0_linux_amd64.tar.gz
sudo install -Dm755 z13gui-plus /usr/local/bin/z13gui-plus

AUR lag: the z13gui-plus-bin AUR package trails the GitHub releases (currently 1.3.0 vs. v2.1.0 — AUR updates are paused). It lacks the tablet integration. For the latest, install the release tarball from GitHub instead of AUR.

See the Installation guide for systemd service setup, source builds, and uninstall instructions.

Quick Start

Press the Armoury Crate button on your Z13 to open the drawer. The Overview shows live system state; Power contains automation, CPU policy, battery strategy, and advanced tuning. Hardware-control changes are sent to the z13ctl-plus daemon.

Upgrading from v1

After installing v2.0.0, copy the complete legacy configuration only if the new Plus configuration directory does not exist:

systemctl --user disable --now z13gui.service
z13gui-plus --migrate-config
systemctl --user enable --now z13gui-plus.service

Migration copies $XDG_CONFIG_HOME/z13gui to $XDG_CONFIG_HOME/z13gui-plus; it leaves the source untouched and does not change services or remove artifacts. Run the disable command only when the old service is known to be from this fork. Legacy names may belong to upstream, so remove old files only after verifying their provenance. See the migration guide.

Documentation

Full documentation at https://aic0d3r.github.io/z13gui-plus

License

Apache 2.0

About

Z13GUI+ adds AC/battery power automation, independent CPU frequency/EPP/boost controls, expanded telemetry, and safer tuning workflows.

Resources

Contributing

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages