==========================

ARandR: Another XRandR GUI

==========================

ARandR is designed to provide a simple visual front end for XRandR_ 1.2/1.3. Relative monitor positions are shown graphically and can be changed in a drag-and-drop way.

Features

--------

* Full control over output positioning (instead of plain "left of") with edge snapping

* Saving configurations as executable shell scripts (configurations can be loaded without using this program)

* Configuration files can be edited to include additional payload (like xsetwacom_ commands tablet PC users need when rotating), which is preserved when editing

* Metacity key binding integration:

    * Saved configurations can be bound to arbitrary keys via metacity's custom commands.

    * Several layouts can be bound to one key; they are cycled through. (Useful for "rotate" buttons on tablet PCs.)

* Main widget separated from packaged application (to facilitate integration with existing solutions)

Installation

------------

* Using your distribution's installer:

    * Debian_ / Ubuntu_::

        aptitude install arandr

    * archlinux_::

        pacman -S arandr

    * Slackware using a `slackbuild by PhantomX`_::

        wget http://cloud.github.com/downloads/PhantomX/slackbuilds/arandr-0.1.4.tar.bz2

        tar xjf arandr-0.1.4.tar.bz2

        cd arandr

        ./arandr.SlackBuild 2>&1 | tee build.log

    * Gentoo_::

        ACCEPT_KEYWORDS="~x86" emerge arandr

      (or ``ACCEPT_KEYWORDS="~amd64" ...`` for 64-bit systems)

* From source:

    * Fetch either

        * the `latest release`_::

            wget http://christian.amsuess.com/tools/arandr/files/arandr-0.1.5.tar.gz

            tar xzf arandr-0.1.5.tar.gz

            cd arandr-0.1.5

        * or get it directly from GIT (`hosted on gitorious`_)::

            git clone git://gitorious.org/arandr/arandr.git

            cd arandr

    * and start it using::

        ./arandr

    * or install it::

        sudo ./setup.py install

Dependencies

------------

 * python_

 * PyGTK_

 * xrandr_

 * docutils_ (>=0.6; for building the man page)

Bugs / Caveats

--------------

 * Changes while running are not caught.

 * Depends on all modes to have a <width>x<height> name (see `debian bug #507521`_).

   * cglita wrote a patch that solves the problem. Until a version is released that includes the changes, use his version if the above does not work for you::

         git clone git://gitorious.org/arandr/arandr.git

         cd arandr

         git checkout cglita

         ./arandr

 * See TODO_ for planned features.

Contributing

------------

If you are fluent with languages not yet supported, you can add translations to ARandR using gettext_. An easy way to do this is `ARandR's transifex site`_ or on `its Launchpad translation site`_.

Please send bug reports, suggestions, patches and git pull requests to me_.

About

-----

Copyright © chrysn_ <chrysn@fsfe.org> 2008–2011, published under GPLv3_ or any later version.

Inspired by the `dual head sketch`_ in the ThinkWiki_.

Translations by

* Quizzlo (Italian)

* Phantom X (Brazilian)

* Joe Hansen (Danish)

* gundachandru (Kannada)

* HsH (Russian)

* Clément Démoulins, Bruno Patri (French)

* RooTer (Polish)

* Mohammad Alhargan, aboodilankaboot (Arabic)

* Mehmet Gülmen (Turkish)

* Ricardo A. Hermosilla Carrillo (Spanish)

* el_libre (Catalan)

* Carezero (Chinese)

* wimfeijen (Dutch)

* Себастьян Gli ţa Κατινα (Romanian)

* Slavko (Slovak)

* Alireza Savand (Persian)

* chrysn (German, English)

 .. _XRandR: http://www.x.org/wiki/Projects/XRandR

 .. _xsetwacom: http://linuxwacom.sourceforge.net/index.php/howto/xsetwacom

 .. _TODO: ./TODO

 .. _`latest release`: http://christian.amsuess.com/tools/arandr/files/arandr-0.1.5.tar.gz

 .. _archlinux: http://www.archlinux.org/packages/community/any/arandr/

 .. _chrysn: http://christian.amsuess.com

 .. _GPLv3: http://www.gnu.org/licenses/gpl-3.0.txt

 .. _`dual head sketch`: http://www.thinkwiki.org/wiki/Image:Intel-DualHead.png

 .. _ThinkWiki: http://thinkwiki.org/

 .. _`hosted on gitorious`: http://gitorious.org/arandr/arandr

 .. _Debian: http://packages.debian.org/arandr

 .. _Ubuntu: http://packages.ubuntu.com/arandr

 .. _gettext: http://www.gnu.org/software/gettext/

 .. _`ARandR's transifex site`: https://transifex.net/projects/p/arandr/

 .. _`its Launchpad translation site`: https://translations.launchpad.net/arandr

 .. _me: mailto:chrysn@fsfe.org

 .. _python: http://www.python.org/

 .. _PyGTK: http://www.pygtk.org/

 .. _`slackbuild by PhantomX`: http://github.com/PhantomX/slackbuilds/tree/master/arandr/

 .. _Gentoo: http://packages.gentoo.org/package/x11-misc/arandr

 .. _docutils: http://docutils.sourceforge.net/

 .. _`debian bug #507521`: http://bugs.debian.org/507521