#title X Configuration
<<Include(X/MenuBar)>>

Today's X rarely requires manual configuration.  X now automatically configures itself with reasonable defaults.  Both GNOME and KDE provide GUI utilities for customizing settings beyond these defaults if you like.

However, sometimes you need to muck with the configuration manually, beyond what these tools allow.

== Quick xorg.conf ==

Most systems don't ship with an X config file any more, but sometimes you need one.  Here's a basic skeleton:

{{{
Section "Device"
        Identifier      "Configured Video Device"
EndSection

Section "Monitor"
        Identifier      "Configured Monitor"
EndSection

Section "Screen"
        Identifier      "Default Screen"
        Monitor         "Configured Monitor"
        Device          "Configured Video Device"
EndSection
}}}

== Configuring using xorg.conf.d (Ubuntu 10.04 and newer) ==

Files ending in *.conf in the {{{/usr/share/X11/xorg.conf.d}}} directory are automatically loaded by X at start prior to reading the xorg.conf.  These files can each contain one or more Sections in the same format used by {{{xorg.conf}}}.

Users can continue making custom configuration in /etc/xorg.conf as usual; the .conf snippets are mainly there for the distro or hw vendor to ship default InputClass rules and custom overrides.

== Configuration Recipes ==

General Configuration
 * [[X/Config/SessionStartup|Session Startup]] - .xprofile, .xsessionrc, .gnomerc
 * [[X/Rootless|Rootless X]] - Running X as a user process, not as the root user
 * [[https://launchpad.net/~xorg-edgers|Xorg On The Edge]] - for bleeding edge packages
 * [[X/Config/Input|Input device configuration]]
 * [[X/Config/Keyboard|Keyboard configuration]]

Display Configuration
   * [[X/Config/Resolution|Display resolution configuration]]
   * [[X/Config/Multihead|Multihead configuration]]
   * [[X/Config/SVideo|SVideo configuration]]
   * [[X/Config/HDMI|HDMI configuration]]
   * [[https://help.ubuntu.com/community/BinaryDriverHowto|Binary Driver Howto]]
   * [[https://help.ubuntu.com/community/HybridGraphics|Hybrid Graphics Howto]]
   * [[https://wiki.ubuntu.com/X/Config/HybridGraphics|Hybrid Graphics (12.04.3 or >=13.10)]]


== Other Resources ==

 * https://help.ubuntu.com/community/DebuggingXAutoconfiguration
 * http://wiki.debian.org/XStrikeForce/HowToRandR12
 * http://www.thinkwiki.org/wiki/Xorg_RandR_1.2
 * http://www.intellinuxgraphics.org/dualhead.html [dead link]
 * https://help.ubuntu.com/community/MultimediaKeys
 * http://en.opensuse.org/GNOME/Multiscreen
 * https://wiki.debian.org/XStrikeForce/InputHotplugGuide
 * https://help.ubuntu.com/community/MultimediaKeys
----
CategoryXTeam<<BR>>