gdctl - GNOME Display Controller
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
--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> .