LinuxCommandLibrary

autorandr

Automatically manage display profiles

TLDR

Save current layout

$ autorandr -s profile_name
copy
List saved profiles
$ autorandr
copy
Auto-detect and apply profile
$ autorandr -c
copy
Load specific profile
$ autorandr -l profile_name
copy
Set default profile
$ autorandr -d profile_name
copy

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.

SEE ALSO

xrandr(1), arandr(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community