gdctl1

Usage

Overview

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.

Commands

show

set

pref

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

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

Options

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

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

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

Options

--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, sdr-native and bt2100.

--rgb-range RGB-RANGE, -r RGB-RANGE

Set the RGB quantization range of the monitor. Available ranges are auto, full and limited (16:235).

Options

--monitor CONNECTOR, -M CONNECTOR

Change monitor preferences. See MONITOR PREFS OPTIONS.

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.

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

Additional information

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