xrandr(1)

NAME

       xrandr - primitive command line interface to RandR extension

SYNOPSIS

       xrandr  [-help]   [-display  display]  [-q]  [-v] [--verbose] [--screen
       snum]
       RandR version 1.2 options
       [--prop]  [--fb  <width>x<height>]  [--fbmm  <width>x<height>]   [--dpi
       <dpi>]
       Per-output options
       [--output  <output>]  [--auto]  [--mode  <mode>]  [--preferred]  [--pos
       <x>x<y>] [--rate <rate>] [--reflect reflection] [--rotate  orientation]
       [--left-of  <output>] [--right-of <output>] [--above <output>] [--below
       <output>] [--off] [--crtc <crtc>]
       RandR version 1.0 and version 1.1 options
       [-o orientation] [-s size] [-x] [-y]

DESCRIPTION

       Xrandr is used to set the size, orientation and/or  reflection  of  the
       outputs for a screen. It can also set the screen size.  There are a few
       global options; the rest modify a  particular  output  and  follow  the
       specification of that output on the command line.

       --help Print out a summary of the usage and exit.

       -v     Print out the RandR version reported by the X server and exit.

       --verbose
              causes  xrandr to be more verbose. When used with -q (or without
              other options), xrandr will display more information  about  the
              server  state. When used along with options that reconfigure the
              system, progress will be reported while executing the configura-
              tion changes.

       -q     When  this  option  is present, or when no configuration changes
              are requested, xrandr will display the current state of the sys-
              tem.

       -screen snum
              This option selects which screen to manipulate. Note this refers
              to the X screen abstraction, not the monitor (or output).

RandR version 1.2 options

       These options are only available for X server supporting RandR  version
       1.2 or newer.

       --prop This  option causes xrandr to display the contents of properties
              for each output. --verbose also enables --prop.

       --fb <width>x<height
              Reconfigures the screen to the specified  size.  All  configured
              monitors must fit within this size. When this option is not pro-
              vided, xrandr computes the smallest screen size that  will  hold
              the  set  of  configured  outputs; this option provides a way to
              override that behaviour.

       --fbmm <width>x<height
              Sets the reported values for the physical size  of  the  screen.
              Normally,  xrandr  resets  the  reported physical size values to
              keep the DPI constant.  This overrides that computation.

       --dpi <dpi>
              This also sets the reported physical size values of the  screen,
              it uses the specified DPI value to compute an appropriate physi-
              cal size using whatever pixel size will be set.

       Per-output options

       --output <output>
              Selects an output to reconfigure. Use either  the  name  of  the
              output or the XID.

       --auto For  connected but disabled outputs, this will enable them using
              their 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 <x>x<y>
              Position the output within the screen using pixel coordinates.

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

       --left-of, --right-of, --above, --below <another output>
              Use one of these options to position the output relative to  the
              position  of  another  output.  This allows convenient tiling of
              outputs within the screen.  The position is always computed rel-
              ative  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.

       --off  Disables the output.

       --crtc <crtc>
              Uses the specified crtc (either as an index in the list of CRTCs
              or XID).  In normal usage, this option is not required as xrandr
              tries to make sensible choices about which crtc to use with each
              output.  When  that fails for some reason, this option can over-
              ride the normal selection.

RandR version 1.1 options

       These options are available for X server supporting RandR  version  1.1
       or older. They are still valid for newer X servers, but they don't

       -s <size index> or -s <width>x<height>
              This  sets the screen size, either matching by size or using the
              index into the list of available sizes.

       -o rotation
              This specifies the orientation of the screen, and can be one  of
              normal, inverted, left or right.

       -x     Reflect across the X axis.

       -y     Reflect across the Y axis.

SEE ALSO

       Xrandr(3)

AUTHORS

       Keith  Packard,  Open Source Technology Center, Intel Corporation.  and
       Jim Gettys, Cambridge Research Laboratory, HP Labs, HP.

X Version 11                     xrandr 1.2.0                        XRANDR(1)