xrandr Command-Line Interface: Usage and Options

XRANDR(1) General Commands Manual XRANDR(1) NAME xrandr - primitive command line interface to RandR extension SYNOPSIS xrandr [--help] [--display display] [-q] [-v] [--verbose] [--dryrun] [--screen snum] [--q1] [--q12] [--current] [--noprimary] [--panning widthxheight[+x+y[/track_widthxtrack_height+track_x+track_y[/bor‐ der_left/border_top/border_right/border_bottom]]]] [--scale x[xy]] [--scale‐from wxh] [--transform a,b,c,d,e,f,g,h,i] [--primary] [--prop] [--fb widthxheight] [--fbmm widthxheight] [--dpi dpi] [--dpi from‐out‐ put] [--newmode name mode] [--rmmode name] [--addmode output name] [--delmode output name] [--output output] [--auto] [--mode mode] [--pre‐ ferred] [--pos xxy] [--rate rate] [--reflect reflection] [--rotate ori‐ entation] [--left-of output] [--right-of output] [--above output] [--be‐ low output] [--same‐as output] [--set property value] [--off] [--crtc crtc] [--gamma red[:green:blue]] [--brightness brightness] [-o orienta‐ tion] [-s size] [-r rate] [-x] [-y] [--listproviders] [--setproviderout‐ putsource provider source] [--setprovideroffloadsink provider sink] [--listmonitors] [--listactivemonitors] [--setmonitor name geometry out‐ puts] [--delmonitor name] 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. If invoked without any option, it will dump the state of the outputs, showing the existing modes for each of them, with a ’+’ after the pre‐ ferred modes and a ’*’ after the current mode. There are a few global options. Other options modify the last output that is specified in earlier parameters in the command line. Multiple outputs may be modified at the same time by passing multiple --output options followed immediately by their corresponding modifying options. --help Print out a summary of the usage and exit. -v, --version 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. Please note that the gamma and brightness informa‐ tions are only approximations of the complete color profile stored in the server. When used along with options that reconfig‐ ure the system, progress will be reported while executing the configuration changes. -q, --query When this option is present, or when no configuration changes are requested, xrandr will display the current state of the system. --dryrun Performs all the actions specified except that no changes are made. --nograb Apply the modifications without grabbing the screen. It avoids to block other applications during the update but it might also cause some applications that detect screen resize to receive old values. -d, --display name This option selects the X display to use. Note this refers to the X screen abstraction, not the monitor (or output). --screen snum This option selects which screen to manipulate. Note this refers to the X screen abstraction, not the monitor (or output). --q1 Forces the usage of the RandR version 1.1 protocol, even if a higher version is available. --q12 Forces the usage of the RandR version 1.2 protocol, even if the display does not report it as supported or a higher version is available.

This document describes the xrandr command-line tool used to manage display outputs and screen configurations using the RandR extension. It covers usage, global options, output-specific options for resizing, rotating, reflecting, positioning, and setting properties of displays. The document details options for querying the current state, making changes, and working with multiple outputs.