Unofficial mirror of
Você não pode selecionar mais de 25 tópicos Os tópicos devem começar com uma letra ou um número, podem incluir traços ('-') e podem ter até 35 caracteres.
Peter Simons bb13853929 Bump version number, update changelog, and re-generate the man page. 8 meses atrás
.github Add and GitHub templates 2 anos atrás
man Bump version number, update changelog, and re-generate the man page. 8 meses atrás
src `XMonad.Operations` * Add `windowBracket`: provide a means of handling windowset changes made during the course of arbitrary `X` actions. Buys composability. * Add `windowBracket_` variant. * Add `modifyWindowSet` utility for use with the above. * Re-implement `sendMessage` using `windowBracket_` so that its refresh handles changes made to the windowset by the message handler. 9 meses atrás
tests typo fix in delete test comment: identiy -> identity 9 meses atrás
util GenerateManpage: fix compiler warnings 10 meses atrás
.gitignore git: ignore "cabal new-build"-style artifacts 10 meses atrás
.travis.yml Don't build generatemanpage with ghc 8.6.x yet: we're lacking pandoc. 10 meses atrás Bump version number, update changelog, and re-generate the man page. 8 meses atrás
CONFIG Update CONFIG instructions: defaultConfig -> def 3 anos atrás Add a section on rebashing and squashing 2 anos atrás
LICENSE clarify copyright 11 anos atrás Update documentation after final release review 2 anos atrás
Main.hs Make ~/.xmonad/xmonad-$arch-$os handle args like /usr/bin/xmonad 4 anos atrás Update Debian packages in README 10 meses atrás
STYLE minor update to STYLE and TODO 3 anos atrás
Setup.lhs Initial import. 12 anos atrás
cabal.project Update documentation after final release review 2 anos atrás
stack.yaml Add a `stack.yaml` file for testing and easy Hackage upload 2 anos atrás
xmonad.cabal Bump version number, update changelog, and re-generate the man page. 8 meses atrás

xmonad: A Tiling Window Manager

Build Status

xmonad is a tiling window manager for X. Windows are arranged automatically to tile the screen without gaps or overlap, maximising screen use. Window manager features are accessible from the keyboard: a mouse is optional. xmonad is written, configured and extensible in Haskell. Custom layout algorithms, key bindings and other extensions may be written by the user in config files. Layouts are applied dynamically, and different layouts may be used on each workspace. Xinerama is fully supported, allowing windows to be tiled on several physical screens.

Quick Start

For the full story, read on.


Building is quite straightforward, and requires a basic Haskell toolchain. On many systems xmonad is available as a binary package in your package system (e.g. on Debian or Gentoo). If at all possible, use this in preference to a source build, as the dependency resolution will be simpler.

We’ll now walk through the complete list of toolchain dependencies.

  • GHC: the Glasgow Haskell Compiler

    You first need a Haskell compiler. Your distribution’s package system will have binaries of GHC (the Glasgow Haskell Compiler), the compiler we use, so install that first. If your operating system’s package system doesn’t provide a binary version of GHC and the cabal-install tool, you can install both using the Haskell Platform.

    It shouldn’t be necessary to compile GHC from source -- every common system has a pre-build binary version. However, if you want to build from source, the following links will be helpful:

  • X11 libraries:

    Since you’re building an X application, you’ll need the C X11 library headers. On many platforms, these come pre-installed. For others, such as Debian, you can get them from your package manager:

    # for xmonad
    $ apt-get install libx11-dev libxinerama-dev libxext-dev libxrandr-dev libxss-dev
    # for xmonad-contrib
    $ apt-get install libxft-dev

Then build and install with:

$ cabal install

Running xmonad

If you built XMonad using cabal then add:

exec $HOME/.cabal/bin/xmonad

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


See the CONFIG document and the example configuration file.


There are many extensions to xmonad available in the XMonadContrib (xmc) library. Examples include an ion3-like tabbed layout, a prompt/program launcher, and various other useful modules. XMonadContrib is available at:

Other Useful Programs

A nicer xterm replacement, that supports resizing better:

For custom status bars:

For a program dispatch menu:


  • Spencer Janssen
  • Don Stewart
  • Jason Creighton