1XRANDR(1x) XRANDR(1x)
2
6 xrandr - primitive command line interface to RandR extension
7
9 xrandr [-help] [-display display] [-q] [-v] [--verbose] [--screen
10 snum]
11 RandR version 1.2 options
12 [--prop] [--fb <width>x<height>] [--fbmm <width>x<height>] [--dpi
13 <dpi>]
14 Per-output options
15 [--output <output>] [--auto] [--mode <mode>] [--preferred] [--pos
16 <x>x<y>] [--rate <rate>] [--reflect reflection] [--rotate orientation]
17 [--left-of <output>] [--right-of <output>] [--above <output>] [--below
18 <output>] [--off] [--crtc <crtc>]
19 RandR version 1.0 and version 1.1 options
20 [-o orientation] [-s size] [-x] [-y]
21
23 Xrandr is used to set the size, orientation and/or reflection of the
24 outputs for a screen. It can also set the screen size. There are a few
25 global options; the rest modify a particular output and follow the
26 specification of that output on the command line.
27 --help Print out a summary of the usage and exit.
29 -v Print out the RandR version reported by the X server and exit.
31 --verbose
33 causes xrandr to be more verbose. When used with -q (or without
34 other options), xrandr will display more information about the
35 server state. When used along with options that reconfigure the
36 system, progress will be reported while executing the configura‐
37 tion changes.
38 -q When this option is present, or when no configuration changes
40 are requested, xrandr will display the current state of the sys‐
41 tem.
42 -screen snum
44 This option selects which screen to manipulate. Note this refers
45 to the X screen abstraction, not the monitor (or output).
46
48 These options are only available for X server supporting RandR version
49 1.2 or newer.
50 --prop This option causes xrandr to display the contents of properties
52 for each output. --verbose also enables --prop.
53 --fb <width>x<height
55 Reconfigures the screen to the specified size. All configured
56 monitors must fit within this size. When this option is not pro‐
57 vided, xrandr computes the smallest screen size that will hold
58 the set of configured outputs; this option provides a way to
59 override that behaviour.
60 --fbmm <width>x<height
62 Sets the reported values for the physical size of the screen.
63 Normally, xrandr resets the reported physical size values to
64 keep the DPI constant. This overrides that computation.
65 --dpi <dpi>
67 This also sets the reported physical size values of the screen,
68 it uses the specified DPI value to compute an appropriate physi‐
69 cal size using whatever pixel size will be set.
70 Per-output options
72 --output <output>
74 Selects an output to reconfigure. Use either the name of the
75 output or the XID.
76 --auto For connected but disabled outputs, this will enable them using
78 their preferred mode (or, something close to 96dpi if they have
79 no preferred mode). For disconnected but enabled outputs, this
80 will disable them.
81 --mode <mode>
83 This selects a mode. Use either the name or the XID for <mode>
84 --preferred
86 This selects the same mode as --auto, but it doesn't automati‐
87 cally enable or disable the output.
88 --pos <x>x<y>
90 Position the output within the screen using pixel coordinates.
91 --rate <rate>
93 This marks a preference for refresh rates close to the specified
94 value, when multiple modes have the same name, this will select
95 the one with the nearest refresh rate.
96 --reflect reflection
98 Reflection can be one of 'normal' 'x', 'y' or 'xy'. This causes
99 the output contents to be reflected across the specified axes.
100 --rotate rotation
102 Rotation can be one of 'normal', 'left', 'right' or 'inverted'.
103 This causes the output contents to be rotated in the specified
104 direction.
105 --left-of, --right-of, --above, --below <another output>
107 Use one of these options to position the output relative to the
108 position of another output. This allows convenient tiling of
109 outputs within the screen. The position is always computed rel‐
110 ative to the new position of the other output, so it is not
111 valid to say --output a --left-of b --output b --left-of a.
112 --off Disables the output.
114 --crtc <crtc>
116 Uses the specified crtc (either as an index in the list of CRTCs
117 or XID). In normal usage, this option is not required as xrandr
118 tries to make sensible choices about which crtc to use with each
119 output. When that fails for some reason, this option can over‐
120 ride the normal selection.
121
123 These options are available for X server supporting RandR version 1.1
124 or older. They are still valid for newer X servers, but they don't
125 -s <size index> or -s <width>x<height>
127 This sets the screen size, either matching by size or using the
128 index into the list of available sizes.
129 -o rotation
131 This specifies the orientation of the screen, and can be one of
132 normal, inverted, left or right.
133 -x Reflect across the X axis.
135 -y Reflect across the Y axis.
137
139 Xrandr(3)
140
142 Keith Packard, Open Source Technology Center, Intel Corporation. and
143 Jim Gettys, Cambridge Research Laboratory, HP Labs, HP.
144X Version 11 xrandr 1.2.0 XRANDR(1x)