README
¶
z13ctld
Linux controls for RGB lighting, performance profiles, native AC/battery power policies, battery limits, fan curves, TDP, CPU undervolting, and display settings on the 2025 ASUS ROG Flow Z13.
z13ctld talks directly to Linux hidraw, asus-wmi, asus-armoury, and
optionally ryzen_smu. Its user daemon persists desired state, restores
volatile controls after resume, handles keyboard reattachment, serializes
hardware writes, and reads the Armoury Crate button without an exclusive evdev
grab.
Native power policies are opt-in. They can assign independent TDP and CPU Curve
Optimizer values to all six AC/battery and power-profiles-daemon combinations;
all default CPU CO values are 0. Without a policy config, the existing manual
controls remain available and PPD/UPower are not policy dependencies.
Install
Follow the Installation guide for verified release
packages, source builds, permission groups, systemd setup, upgrades, and
uninstall steps. Source builds require the Go version declared in
go.mod; tagged Linux amd64 binaries are static and do not require Go
or libc.
Run the daemon as the desktop user, not through sudo. Only setup and
system-wide installation need root. Do not start the user service until any new
group membership is active in the login session.
Quick Start
z13ctld apply --color cyan --brightness high
z13ctld profile --set balanced
z13ctld batterylimit --set 80
z13ctld fancurve --set "48:2,53:22,57:30,60:43,63:56,65:68,70:89,76:102"
z13ctld tdp --set 50
z13ctld undervolt --get
# Opt in to AC/battery policies. Init/reload do not write hardware.
z13ctld policy init
z13ctld policy status
z13ctld policy apply
Curve Optimizer values can destabilize a system; test them under representative loads. The generated policy defaults remain at stock voltage.
Documentation
Documentation
¶
Overview ¶
z13ctld controls hardware on the 2025 ASUS ROG Flow Z13.
It provides RGB, platform-profile, TDP, fan-curve, battery-threshold, Curve Optimizer, and native AC/battery power-policy controls through a CLI and per-user daemon.
Run "z13ctld help" for the current command tree.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
api
module
|
|
|
Package cmd implements the z13ctld CLI subcommands via Cobra.
|
Package cmd implements the z13ctld CLI subcommands via Cobra. |
|
internal
|
|
|
aura
Package aura implements the ASUS Aura HID protocol for the ROG Flow Z13.
|
Package aura implements the ASUS Aura HID protocol for the ROG Flow Z13. |
|
cli
Package cli provides CLI input parsing, color resolution, dry-run display helpers, and sysfs path discovery for z13ctld subcommands.
|
Package cli provides CLI input parsing, color resolution, dry-run display helpers, and sysfs path discovery for z13ctld subcommands. |
|
daemon
Package daemon implements the z13ctld long-running daemon: Unix socket server, hardware device management, state persistence, and Armoury Crate button watcher.
|
Package daemon implements the z13ctld long-running daemon: Unix socket server, hardware device management, state persistence, and Armoury Crate button watcher. |
|
dbusutil
Package dbusutil provides bounded system-bus connection setup shared by the daemon's independent D-Bus watchers.
|
Package dbusutil provides bounded system-bus connection setup shared by the daemon's independent D-Bus watchers. |
|
hid
Package hid provides Linux hidraw device I/O for ASUS Aura-capable peripherals.
|
Package hid provides Linux hidraw device I/O for ASUS Aura-capable peripherals. |
|
powerpolicy
Package powerpolicy implements opt-in AC/battery power policies for z13ctld.
|
Package powerpolicy implements opt-in AC/battery power policies for z13ctld. |
|
releaseconfig
Package releaseconfig renders the tag-specific GoReleaser configuration.
|
Package releaseconfig renders the tag-specific GoReleaser configuration. |
|
userfiles
Package userfiles provides descriptor-pinned file transactions and safe ownership handling for commands run on behalf of a validated sudo user.
|
Package userfiles provides descriptor-pinned file transactions and safe ownership handling for commands run on behalf of a validated sudo user. |
|
scripts
|
|
|
render-goreleaser
command
|