xmonad: A lightweight X11 window manager.

[ bsd3, program, system ] [ Propose Tags ]

Xmonad is a minimalist tiling window manager for X, written in Haskell. Windows are managed using automatic layout algorithms, which can be dynamically reconfigured. At any time windows are arranged so as to maximise the use of screen real estate. All features of the window manager are accessible purely from the keyboard: a mouse is entirely optional. Xmonad is configured in Haskell, and custom layout algorithms may be implemented by the user in config files. A principle of Xmonad is predictability: the user should know in advance precisely the window arrangement that will result from any action.

[Skip to Readme]
Versions [faq] 0.1, 0.2, 0.3, 0.4, 0.4.1, 0.5, 0.6, 0.7, 0.8, 0.8.1, 0.9, 0.9.1, 0.9.2, 0.10, 0.11, 0.11.1, 0.12, 0.13, 0.14, 0.14.1, 0.14.2, 0.15 (info)
Dependencies base (>=2.0 && <3), mtl (>=1.0), unix (>=1.0), X11 (>=1.2.1), X11-extras (>=0.3) [details]
License BSD-3-Clause
Author Spencer Janssen
Maintainer sjanssen@cse.unl.edu
Revised Revision 1 made by HerbertValerioRiedel at 2015-01-13T13:03:50Z
Category System
Home page http://xmonad.org
Uploaded by SpencerJanssen at 2007-09-04T19:56:20Z
Distributions Arch:0.15, Debian:0.14.2, Fedora:0.15, FreeBSD:0.11.1, LTSHaskell:0.15, NixOS:0.15, Stackage:0.15, openSUSE:0.15
Executables xmonad
Downloads 42446 total (285 in the last 30 days)
Rating 2.5 (votes: 6) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs not available [build log]
All reported builds failed as of 2016-12-11 [all 8 reports]


Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Maintainer's Corner

For package maintainers and hackage trustees

Readme for xmonad-0.3

[back to package description]
               xmonad : a lightweight X11 window manager.




    Xmonad is a tiling window manager for X. Windows are managed using
    automatic tiling algorithms, which can be dynamically configured.
    Windows are arranged so as to tile the screen without gaps, maximising
    screen use. All features of the window manager are accessible 
    from the keyboard: a mouse is strictly optional. Xmonad is written
    and extensible in Haskell, and custom layout algorithms may be
    implemented by the user in config files. A guiding principle of the
    user interface is <i>predictability</i>: users should know in
    advance precisely the window arrangement that will result from any
    action, leading to an intuitive user interface.

    Xmonad provides three tiling algorithms by default: tall, wide and
    fullscreen. In tall or wide mode, all windows are visible and tiled
    to fill the plane without gaps. In fullscreen mode only the focused
    window is visible, filling the screen.  Alternative tiling
    algorithms are provided as extensions. Sets of windows are grouped
    together on virtual workspaces and each workspace retains its own
    layout. Multiple physical monitors are supported via Xinerama,
    allowing simultaneous display of several workspaces.

    Adhering to a minimalist philosophy of doing one job, and doing it
    well, the entire code base remains tiny, and is written to be simple
    to understand and modify. By using Haskell as a configuration
    language arbitrarily complex extensions may be implemented by the
    user using a powerful `scripting' language, without needing to
    modify the window manager directly. For example, users may write
    their own tiling algorithms.



Get the dependencies

    It is likely that you already have some of these dependencies.  To check
    whether you've got a package run 'ghc-pkg list some_package_name'

    mtl             http://hackage.haskell.org/cgi-bin/hackage-scripts/package/mtl-1.0
    unix            http://hackage.haskell.org/cgi-bin/hackage-scripts/package/unix-2.0 
    X11             http://hackage.haskell.org/cgi-bin/hackage-scripts/package/X11-1.2.2
    X11-extras:     http://hackage.haskell.org/cgi-bin/hackage-scripts/package/X11-extras-0.3

And then build with Cabal:

    runhaskell Setup.lhs configure --prefix=$HOME
    runhaskell Setup.lhs build
    runhaskell Setup.lhs install --user


Notes for using the darcs version

    If you're building the darcs version of xmonad, be sure to also
    use the darcs version of X11-extras, which is developed concurrently
    with xmonad.

        darcs get http://darcs.haskell.org/~sjanssen/X11-extras

    Not using X11-extras from darcs, is the most common reason for the
    darcs version of xmonad to fail to build.


Running xmonad:



    to the last line of your .xsession or .xinitrc file.



    There are various contributed modules that can be used with xmonad.
    Examples include an ion3-like tabbed layout, a prompt/program launcher,
    and various other useful modules.  XMonadContrib is available at:

    0.3 release:   http://www.xmonad.org/XMonadContrib-0.3.tar.gz

    darcs version: darcs get http://darcs.haskell.org/~sjanssen/XMonadContrib


Other useful programs:

 For a program dispatch menu:

    dmenu           http://www.suckless.org/download/
    gmrun           (in your package system)

 For custom status bars:

    dzen            http://gotmor.googlepages.com/dzen

 A nicer xterm replacment, that supports resizing better:

    urxvt           http://software.schmorp.de/pkg/rxvt-unicode.html


    Spencer Janssen
    Don Stewart
    Jason Creighton