autorandr
Automatically manage display profiles
TLDR
Save current layout
SYNOPSIS
autorandr [OPTIONS] [PROFILE]
DESCRIPTION
autorandr automatically detects connected displays and applies the appropriate screen layout based on saved profiles. It integrates with xrandr and can automatically switch profiles when monitors are connected or disconnected.
Profiles are identified by the EDID fingerprint of connected displays, allowing seamless switching between different monitor configurations such as docking stations, projectors, or standalone laptop use. The tool can be triggered manually or run as a udev or systemd hook for fully automatic profile switching.
PARAMETERS
-s, --save name
Save current screen layout as a profile-l, --load name
Load a specific profile-c, --change
Automatically detect and load the appropriate profile-d, --default name
Set the default profile (used when no match is found)--fingerprint
Display the current setup's fingerprint--remove name
Remove a saved profile--batch
Run in batch mode (no confirmation)--skip-options options
Skip certain xrandr options when comparing
CONFIGURATION
~/.config/autorandr/
Directory containing saved display profiles. Each profile is a subdirectory with setup and config files.
CAVEATS
Requires xrandr to be installed. Profile matching is based on connected display EDIDs. Virtual displays or displays without valid EDID may not be matched correctly.
HISTORY
autorandr simplifies multi-monitor setup by automatically detecting and applying saved configurations, commonly used with laptop docking stations and external displays.
