Repository files navigation

A tiling window manager for X11.

XMonad is a tiling window manager for X11. Windows are arrangedautomatically to tile the screen without gaps or overlap, maximisingscreen use. Window manager features are accessible from the keyboard:a mouse is optional. xmonad is written, configured and extensible inHaskell. Custom layout algorithms, key bindings and other extensionsmay be written by the user in config files. Layouts are applieddynamically, and different layouts may be used on eachworkspace. Xinerama is fully supported, allowing windows to be tiledon several physical screens.

This repository contains thexmonad package, a minimal,stable, yet extensible core. It is accompanied byxmonad-contrib, a library of hundreds of additionalcommunity-maintained tiling algorithms and extension modules. The two combinedmake for a powerful X11 window-manager with endless customizationpossibilities. They are, quite literally, libraries for creating your ownwindow manager.

For installation and configuration instructions, please see:

• downloading and installing xmonad
• installing latest xmonad snapshot from git
• configuring xmonad

If you run into any trouble, consult ourdocumentation orask thecommunity for help.

We welcome all forms of contributions:

• bug reports and feature ideas(also toxmonad-contrib)
• bug fixes, new features, new extensions(usually toxmonad-contrib)
• documentation fixes and improvements:xmonad,xmonad-contrib,xmonad-web
• helping others in thecommunity
• financial support:GitHub Sponsors,Open Collective

Please do read theCONTRIBUTING document for moreinformation about bug reporting and code contributions. For a brief overviewof the architecture and code conventions, see thedocumentation for theXMonad.Doc.Developing module. If in doubt,talk tous.

Started in 2007 bySpencer Janssen,DonStewart andJason Creighton, theXMonad project lives on thanks tonew generations ofmaintainers anddozens ofcontributors.