gdctl - Man Page

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> .