GDCTL(1) User Commands GDCTL(1)

gdctl - GNOME Display Controller

gdctl [-h] COMMAND ...

gdctl provides means to show the active monitor configuration, and set new monitor configuration using command line arguments.

It requires a compositor that supports the org.gnome.Mutter.DisplayConfig D-Bus API, such as GNOME Shell.

show

Show the current display configuration

set

Set a new display configuration

pref

Set display related preferences.

--help, -h

Show a help message and exit.

--modes, -m

List available monitor modes.

--properties, -p

List properties.

--verbose, -v

Display all available information (equivalent to --modes --properties).

--help, -h

Show a help message and exit.

--persistent, -P

Store applied configuration on persistent storage and restore when applicable.

--verbose, -v

Print configuration to standard out before applying it.

--verify, -V

Only verify, without applying, the configuration.

--layout-mode LAYOUT-MODE, -l

Specify the layout mode the configuration should use. Either logical, or physical.

--logical-monitor, -L

Add and configure a logical monitor. See LOGICAL MONITOR OPTIONS.

--for-lease-monitor CONNECTOR, -e CONNECTOR

Set a monitor, that is not part of any logical monitor, available for lease.

--monitor CONNECTOR, -M CONNECTOR

Add a monitor to the currently configured logical monitor. All monitors within the same logical monitor must have the same monitor resolution.

--primary, -p

Mark currently configured logical monitor as primary.

--scale SCALE, -s SCALE

Scale monitors within the currently configured logical monitor with SCALE. Must be a scale supported by all monitors and their configured modes.

--transform TRANSFORM, -t TRANSFORM

Transform monitors within the currently configured logical monitor using TRANSFORM. Possible transforms are normal, 90, 180, 270, flipped, flipped-90, flipped-270 and flipped-180.

--x X, -x X

Set the X position of the currently configured logical monitor.

--y Y, -y Y Y position

Set the Y position of the currently configured logical monitor.

--right-of CONNECTOR

Place the logical monitor to the right of the logical monitor CONNECTOR belongs to.

--left-of CONNECTOR Place left of other monitor

Place the logical monitor to the left of the logical monitor CONNECTOR belongs to.

--above CONNECTOR

Place the logical monitor above the logical monitor CONNECTOR belongs to.

--below CONNECTOR

Place the logical monitor below the logical monitor CONNECTOR belongs to.

--mode MODE, -m MODE

Set the mode of the monitor.

--color-mode COLOR-MODE, -c COLOR-MODE

Set the color mode of the monitor. Available color modes are default and bt2100.

--monitor CONNECTOR, -M CONNECTOR

Change monitor preferences. See MONITOR PREFS OPTIONS.

--luminance LUMINANCE, -l LUMINANCE

Set the luminance of the monitor for the current color mode.

--reset-luminance

Reset the luminance of the monitor for the current color mode to its default.

Mirror DP-1 and eDP-1, and place DP-2, transformed by 270 degrees, to the right of the two mirrored monitors.

gdctl set --logical-monitor
          --primary
          --monitor DP-1
          --monitor eDP-1
          --logical-monitor
          --monitor DP-2
          --right-of DP-1
          --transform 270

Set eDP-1 and DP-2 as available for lease.

gdctl set --logical-monitor
          --primary
          --monitor DP-1
          --for-lease-monitor eDP-1
          --for-lease-monitor DP-2

The bug tracker can be reached by visiting the website
https://gitlab.gnome.org/GNOME/mutter/-/issues . Before sending a bug report, please verify that you have the latest version of gnome-shell. Many bugs (major and minor) are fixed at each release, and if yours is out of date, the problem may already have been solved.

For further information, visit the website
https://gitlab.gnome.org/GNOME/mutter/-/blob/main/README.md .