gdctl - GNOME Display Controller
Contents
Additional Information
For further information, visit the website
<https://gitlab.gnome.org/GNOME/mutter/-/blob/main/README.md> .
GDCTL(1)
Bugs
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.
Commands
show
Show the current display configuration
set
Set a new display configuration
pref
Set display related preferences.
Description
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.
Examples
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
Logical Monitor Options
--monitorCONNECTOR, -MCONNECTOR
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.
--scaleSCALE, -sSCALE
Scale monitors within the currently configured logical monitor with SCALE. Must be a scale supported
by all monitors and their configured modes.
--transformTRANSFORM, -tTRANSFORM
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.
--xX, -xX
Set the X position of the currently configured logical monitor.
--yY, -yY Y position
Set the Y position of the currently configured logical monitor.
--right-ofCONNECTOR
Place the logical monitor to the right of the logical monitor CONNECTOR belongs to.
--left-ofCONNECTOR Place left of other monitor
Place the logical monitor to the left of the logical monitor CONNECTOR belongs to.
--aboveCONNECTOR
Place the logical monitor above the logical monitor CONNECTOR belongs to.
--belowCONNECTOR
Place the logical monitor below the logical monitor CONNECTOR belongs to.
Monitor Options
--modeMODE, -mMODE
Set the mode of the monitor.
--color-modeCOLOR-MODE, -cCOLOR-MODE
Set the color mode of the monitor. Available color modes are default and bt2100.
Monitor Prefs Options
--luminanceLUMINANCE, -lLUMINANCE
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.
Name
gdctl - GNOME Display Controller
Prefs Options
--monitorCONNECTOR, -MCONNECTOR
Change monitor preferences. See MONITOR PREFS OPTIONS.
Set Options
--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-modeLAYOUT-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-monitorCONNECTOR, -eCONNECTOR
Set a monitor, that is not part of any logical monitor, available for lease.
Show Options
--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).
Synopsis
gdctl [-h] COMMAND ...
