quickrandr
A command line tool for saving and restoring xrandr display configurations.
It works by parsing xrandrs output, and generating commands for it.
NOTE: The tool currently completely ignores xrandrs
VIRTUAL*
outputs due to technical reasons.
CLI interface
USAGE:
quickrandr [FLAGS] [OPTIONS]
FLAGS:
-a, --auto Automatically configures the displays according to the config file.
-n, --create-empty Creates an empty config file.
--debug Does verbose printing, and only simulates calls to xrandr.
-h, --help Prints help information
-i, --info Prints the contents of the config file and the current connected hardware in an abbreviated
form.
-s, --save Stores the current display configuration to the config file for a later automatic display
configuration.
-V, --version Prints version information
OPTIONS:
-c, --config <FILE> Sets a custom config file. If not given, it stores it in the users config file
directory.
-d, --default-profile <PROFILE> Selects a profile to apply in case --auto does not recognize the current system
config.
-p, --profile <PROFILE> Applies the given profile.
Example config file
- The entries under
autoprofiles
are automatically generated by the--save
option, and represent the database of all known display configurations. - The entries under
profiles
are optional, user-specified display configurations, that can be used either as a fallback for the automatic configuration, or for forcefully applying a different display configuration regardless of connected displays.