Skip to content

About

Simple tool to adjust X display settings

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

6 Commits

Folders and files

Repository files navigation

zigautorandr

autorandr-style monitor profiles for X11, but matched by EDID instead of output names (DisplayPort-6 may become DisplayPort-8 after a dock/MST re-enumeration; the monitor's EDID doesn't change).

Pure Zig (0.16), stdlib only: it speaks the X11 protocol and the RandR extension directly over /tmp/.X11-unix/X<n> (with MIT-MAGIC-COOKIE auth from ~/.Xauthority). No Xlib/xcb, no xrandr binary.

zig build -Doptimize=ReleaseSafe     # -> zig-out/bin/zigautorandr
zig build test
zig-out/bin/zigautorandr --version

Installing

The build's default (install) step copies the binary to <prefix>/bin; the prefix defaults to zig-out. To install into ~/.local/bin:

zig build -Doptimize=ReleaseSafe --prefix ~/.local    # -> ~/.local/bin/zigautorandr
zig build uninstall --prefix ~/.local                 # removes it again

Usage

zigautorandr                  # connected monitors + profiles (detected/current)
zigautorandr save docked      # store the current layout
zigautorandr change           # apply the profile matching the connected monitors
zigautorandr load docked      # apply a specific profile
zigautorandr daemon           # watch RandR hotplug events, run `change` on each
zigautorandr --dry-run change # show what would be done

Start zigautorandr daemon & from ~/.xinitrc / your WM autostart to switch automatically on hotplug (no udev rule needed).

Profiles live in $XDG_CONFIG_HOME/zigautorandr/<name>.json. An executable $XDG_CONFIG_HOME/zigautorandr/postswitch is run with the profile name after a switch (e.g. to restart your bar or reset the wallpaper).

How matching works

  • Fingerprint = SHA-256 of the 128 byte EDID base block (extension blocks are ignored because some monitors rewrite them when FreeSync/HDR is toggled).
  • EDID is read from the RandR EDID output property; if the driver doesn't provide it, from /sys/class/drm/*/edid via the CONNECTOR_ID property. Outputs without any EDID fall back to output:<name>.
  • A profile matches if the set of connected fingerprints is equal. Identical monitors (same EDID, e.g. no serial number) are told apart by output name.
  • With several matching profiles, change keeps an already active one, otherwise applies the alphabetically first.

Scaling

The CRTC transform (xrandr --scale, --scale-from, --transform) is saved per output as a 3x3 row-major matrix plus the scaling filter; outputs without it are unscaled. E.g. xrandr --output eDP --scale 0.5x0.5 is stored as

"transform": [0.5, 0, 0, 0, 0.5, 0, 0, 0, 1],
"filter": "bilinear"

and the screen size is computed from the scaled size of each output. Filter parameters (convolution filters) are not saved.

Not supported (yet)

Panning, gamma, custom DPI (screen size is set at 96 DPI), TCP DISPLAYs.

Continuing development

Code map: src/x11.zig (X11 + RandR wire protocol), src/edid.zig (EDID parsing and fingerprint), src/main.zig (profiles, matching, apply, CLI, daemon). See CLAUDE.md for conventions and how to test safely against a live X server (scratch XDG_CONFIG_HOME, --dry-run first).

Open items, roughly by usefulness:

  1. Real hotplug testing of daemon. Only startup and idle waiting have been exercised; verify dock/undock, sleep/resume and MST re-enumeration. Check whether 1.5 s debounce is enough for docks.
  2. Fallback profile for unknown monitor sets (autorandr's --default), e.g. enable all connected outputs side by side at preferred mode.
  3. Profile priority when several profiles match the same monitors (currently: keep the active one, else alphabetical first). Options: remember the last used profile per monitor set, or a priority field.
  4. DPI: optional dpi per profile instead of the fixed 96 DPI used for the screen's physical size.
  5. Panning (GetPanning/SetPanning, minors 28/29) and gamma (minors 22–24), if needed.
  6. TCP displays (host:N → port 6000+N) and the Linux abstract socket @/tmp/.X11-unix/XN for sandboxed environments.
  7. Mirroring onto one CRTC: today every enabled output gets its own CRTC; if a GPU runs out of CRTCs, outputs with identical mode/position could share one.

When adding fields to profiles, give them defaults so existing JSON files keep loading, and don't change the fingerprint without a migration path.

Versioning and releases

The version lives in exactly one place: .version in build.zig.zon (semver). build.zig combines it with git describe for --version:

checkout zigautorandr --version
clean tag v0.2.0 0.2.0
3 commits after v0.2.0 0.2.0-dev.3+gabc1234
uncommitted changes ...+gabc1234.dirty
no matching tag / no git 0.2.0-dev+gabc1234 / 0.2.0

zig build -Dversion-string=... overrides it (e.g. for distro packages built from a tarball). Building a clean tag that disagrees with build.zig.zon fails on purpose.

To release:

  1. Bump .version in build.zig.zon (0.2.0, or 0.2.0-rc1 for a pre-release).
  2. Commit: git commit -am "Release 0.2.0"
  3. Tag and push: git tag v0.2.0 && git push origin master v0.2.0

The tag triggers .github/workflows/release.yml, which runs the tests, builds static x86_64-linux-musl and aarch64-linux-musl binaries (ReleaseSafe), checks that --version matches the tag, and publishes a GitHub release with the tarballs, SHA256SUMS and generated release notes. Tags containing - are marked as pre-releases. .github/workflows/ci.yml checks formatting, tests and the release targets on every push to master and on pull requests.

About

Simple tool to adjust X display settings

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages