z13gui

command module

v1.3.0 Latest Latest Go to latest Published: Jul 29, 2026 License: Apache-2.0 Imports: 11 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/dahui/z13gui

Links

Open Source Insights

README ¶

z13gui

GTK4 overlay drawer for z13ctl on Wayland.

z13gui

z13gui is the graphical companion to z13ctl — a slide-out drawer triggered by the Armoury Crate button (KEY_PROG3). It renders as a Wayland layer-shell overlay (KDE Plasma, Hyprland, Sway) or as a gamescope X11 overlay in Steam Gaming Mode. All hardware communication goes through the z13ctl daemon.

Install

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

# Debian / Ubuntu
sudo apt install ./z13gui_*.deb

# Fedora / RHEL
sudo dnf install ./z13gui_*.rpm

# Manual (from release tarball)
tar xzf z13gui_*_linux_amd64.tar.gz
sudo install -Dm755 z13gui /usr/local/bin/z13gui

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. Press it again, click outside, or press Escape to close it.

The drawer controls profiles, battery charge limit, RGB lighting (mode, color, speed, brightness), panel overdrive, and boot sound. All changes are sent to the z13ctl daemon immediately and persist across reboots.

Documentation

Full documentation at https://dahui.github.io/z13gui

License

Apache 2.0

Documentation ¶

There is no documentation for this package.

Source Files ¶

View all Source files

main.go

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
internal
colorconv Package colorconv converts between the RRGGBB hex strings the z13ctl daemon speaks and the HSL components the drawer's colour picker manipulates.	Package colorconv converts between the RRGGBB hex strings the z13ctl daemon speaks and the HSL components the drawer's colour picker manipulates.
daemon Package daemon turns a z13ctl api call's result pair into a single error.	Package daemon turns a z13ctl api call's result pair into a single error.
focusgrid Package focusgrid is the gamepad focus navigation for the drawer: given a set of items laid out in rows, columns and sections, it answers "which item does this D-pad press move to".	Package focusgrid is the gamepad focus navigation for the drawer: given a set of items laid out in rows, columns and sections, it answers "which item does this D-pad press move to".
gui Package gui implements the GTK4 overlay drawer for z13gui.	Package gui implements the GTK4 overlay drawer for z13gui.
gui/fonts Package fonts embeds the Inter typeface and registers it with fontconfig at application startup so the drawer renders identically across desktop (KDE/Wayland) and gamescope (Steam Gaming Mode) environments.	Package fonts embeds the Inter typeface and registers it with fontconfig at application startup so the drawer renders identically across desktop (KDE/Wayland) and gamescope (Steam Gaming Mode) environments.
gui/gamepad Package gamepad reads Linux evdev gamepad events and dispatches normalized actions to the GUI.	Package gamepad reads Linux evdev gamepad events and dispatches normalized actions to the GUI.
gui/gamepad/hidblocker
gui/gamescope Package gamescope implements the X11 overlay display backend for gamescope (Steam Gaming Mode).	Package gamescope implements the X11 overlay display backend for gamescope (Steam Gaming Mode).
gui/layershell Package layershell implements the Wayland layer-shell display backend.	Package layershell implements the Wayland layer-shell display backend.
keyrepeat Package keyrepeat decides which held direction owns a gamepad's auto-repeat.	Package keyrepeat decides which held direction owns a gamepad's auto-repeat.
lighting Package lighting holds the drawer's RGB lighting rules: which mode a daemon state represents, which controls that mode needs, and what to fall back to when state is missing.	Package lighting holds the drawer's RGB lighting rules: which mode a daemon state represents, which controls that mode needs, and what to fall back to when state is missing.
power Package power holds the TDP and fan-curve rules the drawer needs in order to avoid offering the user a state the z13ctl daemon would refuse.	Package power holds the TDP and fan-curve rules the drawer needs in order to avoid offering the user a state the z13ctl daemon would refuse.
startup Package startup holds the process-startup logic that runs before any GTK code: command-line scanning and log filtering.	Package startup holds the process-startup logic that runs before any GTK code: command-line scanning and log filtering.
theme Package theme provides color theme definitions, configuration persistence, and CSS generation for the z13gui overlay drawer.	Package theme provides color theme definitions, configuration persistence, and CSS generation for the z13gui overlay drawer.
togglegate
uiscale Package uiscale computes the drawer's UI scale factor for the gamescope backend, where GTK cannot be asked to scale for us.	Package uiscale computes the drawer's UI scale factor for the gamescope backend, where GTK cannot be asked to scale for us.