the default (96 DPI), the DPI of the only monitor in single‐moni‐
tor configurations, or the DPI of the primary monitor in multi‐
monitor configurations.
--newmode name mode
New modelines can be added to the server and then associated with
outputs. This option does the former. The mode is specified us‐
ing the ModeLine syntax for xorg.conf: clock hdisp hsyncstart
hsyncend htotal vdisp vsyncstart vsyncend vtotal flags. flags can
be zero or more of +HSync, ‐HSync, +VSync, ‐VSync, Interlace,
DoubleScan, CSync, +CSync, ‐CSync. Several tools permit to com‐
pute the usual modeline from a height, width, and refresh rate,
for instance you can use cvt.
--rmmode name
This removes a mode from the server if it is otherwise unused.
--addmode output name
Add a mode to the set of valid modes for an output.
--delmode output name
Remove a mode from the set of valid modes for an output.
Per‐output options
--output output
Selects an output to reconfigure. Use either the name of the out‐
put or the XID.
--auto For connected but disabled outputs, this will enable them using
their first preferred mode (or, something close to 96dpi if they
have no preferred mode). For disconnected but enabled outputs,
this will disable them.
--mode mode
This selects a mode. Use either the name or the XID for mode
--preferred
This selects the same mode as --auto, but it doesn’t automati‐
cally enable or disable the output.
--pos xxy
Position the output within the screen using pixel coordinates. In
case reflection or rotation is applied, the translation is ap‐
plied after the effects.
--rate rate
This marks a preference for refresh rates close to the specified
value, when multiple modes have the same name, this will select
the one with the nearest refresh rate.
--reflect reflection
Reflection can be one of ’normal’ ’x’, ’y’ or ’xy’. This causes
the output contents to be reflected across the specified axes.
--rotate rotation
Rotation can be one of ’normal’, ’left’, ’right’ or ’inverted’.
This causes the output contents to be rotated in the specified
direction. ’right’ specifies a clockwise rotation of the picture
and ’left’ specifies a counter‐clockwise rotation.
--left-of, --right-of, --above, --below, --same‐as another‐output
Use one of these options to position the output relative to the
position of another output. This allows convenient tiling of out‐
puts within the screen. The position is always computed relative
to the new position of the other output, so it is not valid to
say --output a --left-of b --output b --left-of a.
--set property value
Sets an output property. Integer properties may be specified as a
valid (see --prop) comma‐separated list of decimal or hexadecimal
(with a leading 0x) values. Atom properties may be set to any of
the valid atoms (see --prop). String properties may be set to
any value.
--off Disables the output.
--crtc crtc
Uses the specified crtc (either as an index in the list of CRTCs
or XID).