Xorg.conf

The file is the main configuration file for the X server.

xorg.conf.d, xorg.conf
The X server read the settings from the files in directory (recommended) or the legacy  file. In the directory, each file is given a unique name and ends in. If the filenames start with a number, then the X server will read the files in numeric order. will be read before, and so on. You don't have to give them numbers, but it may help you organize them.

The settings in take precedence over the files in, which take precedence over the files in , which take precedence over the built-in X server configuration.

provides example configurations in. You can use these to create your own configuration files in.

Syntax
The configuration is composed of a number of sections. The most common ones include:


 * ServerFlags: Common X server settings
 * InputClass: Settings for input devices
 * Device: Settings for graphics cards
 * Monitor: Settings for displays
 * Screen: Settings for "graphics card / display"-combinations
 * ServerLayout: Settings for "screen / input devices"-combinations

Lines starting with a hash (#) are comments and are ignored by the X server. Each other line in a section define a value to an option. The value can be of the following types:


 * INTEGER: an integer number in decimal, hex or octal, e.g. 1, 2, 3, etc.
 * REAL: a floating point number, e.g. 1.2
 * STRING: a string enclosed in double quote marks ("), e.g. "Hello world!"

Most options and values are case-insensitive. Superfluous white spaces are ignored.

The special option named Option accepts also the additional types:


 * BOOLEAN: a boolean value, e.g. on, true, 1 or yes; off, false, 0 or no.
 * FREQUENCY: in Hz, k, kHz, M or MHz

Note also that the Option values must be enclosed in double quote marks (").

ServerFlags
An example ServerFlags section looks like this:

All entries are optional.

The most common options are:

For more information see the man page.

InputClass
Create for each input device class (keyboard, mouse, etc.) a InputClass section. An example InputClass section looks like this:

Identifier is mandatory, everything else is optional.

Without specify a matching condition a InputClass section applies to all input devices. Add a matching condition to apply settings only to input devices of the target class or to a single device. The most common conditions are:

The most common options are:

For more information see the man page and the man pages of your input device drivers.

Device
Create for each graphics card a Device section. An example Device section looks like this:

Identifier and Driver is mandatory, everything else is optional.

The most common options are:

For more information see the man page and the man pages of your graphics drivers.

Monitor
Create for each monitor a Monitor section. An example Monitor section looks like this:

Identifier is mandatory, everything else is optional.

The most common options are:

For more information see the man page.