displayconfig-mutter

July 20, 2025 ยท View on GitHub

xrandr like app for Gnome DE in Wayland mode. Allows modifying most parameters that are exposed in "Displays" settings.

Go to installation instructions.

# displayconfig-mutter --help
Usage: displayconfig-mutter <COMMAND>

Commands:
  list  List monitors
  set   Set config
  help  Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version
# displayconfig-mutter list --help
List monitors

Usage: displayconfig-mutter list [OPTIONS]

Options:
  -c, --connector <CONNECTOR>  If specified - will list all available modes for a monitor with matching connector name
  -h, --help                   Print help
# displayconfig-mutter set --help
Set config

Usage: displayconfig-mutter set [OPTIONS] --connector <CONNECTOR>

Options:
  -c, --connector <CONNECTOR>        Name of monitor connector, e.g. DP-1, HDMI-2
  -p, --persistent                   Save config to the disk after applying it. Will prompt for user input to verify if it's correct
  -r, --resolution <RESOLUTION>      New resolution, e.g. 1920x1080, 3840x2160
      --max-resolution               Automatically select highest available refresh rate
      --refresh-rate <REFRESH_RATE>  New monitor refresh rate. This is selected on a best effort basis. e.g. if you select 60Hz, while monitor only supports 59.98Hz, it will be selected instead
      --max-refresh-rate             Automatically select highest refresh rate for selected resolution
      --vrr <VRR>                    Controls variable refresh rate [possible values: true, false]
      --scaling <SCALING>            UI Scaling, as percentage, e.g. 100, 150, 200. This is selected based on a closest available scaling with a rounding step of 25%. e.g. if you select 125, while selected resolution only allows for either 124% or 149% - first one will be selected
      --hdr <HDR>                    Controls high dynamic range color mode [possible values: true, false]
  -h, --help                         Print help

Installation

NixOS / Nix

nix run github:eaglesemanation/displayconfig-mutter -- help

Arch Linux

Available through AUR. You can clone it and build it manually, or use one of many AUR helpers, such as yay

yay -S displayconfig-mutter

Fedora Linux

Available through COPR.

sudo dnf copr enable eaglesemanation/displayconfig-mutter
sudo dnf install displayconfig-mutter

Ubuntu / Linux Mint

Available through Launchpad PPA.

sudo add-apt-repository ppa:eaglesemanation/displayconfig-mutter
sudo apt update
sudo apt install displayconfig-mutter

Others

Releases page contains pre-built binaries for x86_64 (Intel / AMD) and aarch64 (ARM) processors. You can install them on most distros by running this:

curl "https://github.com/eaglesemanation/displayconfig-mutter/releases/latest/download/displayconfig-mutter-$(uname -m)" -L -o displayconfig-mutter \
  && sudo install -Dm0755 displayconfig-mutter /usr/local/bin/displayconfig-mutter \
  && rm displayconfig-mutter