xrandrw

Zero-config, self-healing X11 display-layout daemon for dwm/i3 and other bare-X11 window managers. It watches for monitor hotplug/unplug, remembers each display by its EDID identity, and auto-places externals relative to a primary using a persistent attach-order policy — so your monitors end up where you left them, every time.

Pure Python standard library (optional systemd-python for journald logging).

Install

End-user (isolated, lands the xrandrw console-script at ~/.local/bin):

pipx install .

Development (editable):

pip install -e .

Optional journald logging extra:

pip install ".[journald]"

Usage

xrandrw exposes six modes:

Configuration

Config resolves from (lowest to highest precedence): built-in defaults → /etc/xdg/xrandrw.conf → ~/.config/xrandrw.conf → process environment. Each key can be set in a config file (KEY=value lines) or via an environment variable of the same name.

See xrandrw.conf.sample for an annotated template — copy it to ~/.config/xrandrw.conf and edit.

systemd user service

The repo ships a --user unit that runs xrandrw --daemon with Restart=always and sd_notify integration. Install and enable it via the Makefile:

make install    # pipx install . + copy conf sample + unit
make enable     # systemctl --user daemon-reload && enable --now

make install uses pipx install --force ., which places the console-script at ~/.local/bin/xrandrw — exactly the ExecStart path the unit expects. Run systemctl --user daemon-reload after any reinstall.

License

MIT — see LICENSE.