The xmonad package

[Tags: bsd3, program]

xmonad is a tiling window manager for X. Windows are arranged automatically to tile the screen without gaps or overlap, 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. Custom layout algorithms, 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 screens.


[Skip to ReadMe]

Properties

Versions0.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
Change logCHANGES.md
Dependenciesbase (>=3 && <5), containers, data-default, directory, extensible-exceptions, filepath, mtl, process, setlocale, unix, utf8-string (>=0.3 && <1.1), X11 (>=1.5 && <1.7), xmonad [details]
LicenseBSD3
AuthorSpencer Janssen
Maintainerxmonad@haskell.org
CategorySystem
Home pagehttp://xmonad.org
Bug trackerhttps://github.com/xmonad/xmonad/issues
Source repositoryhead: git clone https://github.com/xmonad/xmonad
Executablesgeneratemanpage, xmonad
UploadedMon Dec 21 19:13:00 UTC 2015 by BrentYorgey
DistributionsArch:0.12, Debian:0.12, Fedora:0.11, FreeBSD:0.11.1, LTSHaskell:0.12, NixOS:0.12, Stackage:0.12
Downloads17149 total (149 in last 30 days)
Votes
1 []
StatusDocs available [build log]
Last success reported on 2015-12-21 [all 1 reports]

Modules

[Index]

Flags

NameDescriptionDefaultType
testingTesting mode, only build minimal componentsDisabledAutomatic
generatemanpageBuild the tool for generating the man pageDisabledManual

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Maintainers' corner

For package maintainers and hackage trustees

Readme for xmonad-0.12

xmonad: A Tiling Window Manager

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

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.

Running xmonad

Add:

exec $HOME/.cabal/bin/xmonad

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

Configuring

See the CONFIG document.

XMonadContrib

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:

Authors