Community-maintained extensions for xmonad.

Community-maintained tiling algorithms and extension modules for xmonad, an X11 tiling window manager.

For an introduction to building, configuring and using xmonad extensions, see XMonad.Doc. In particular:

XMonad.Doc.Configuring, a guide to configuring xmonad

XMonad.Doc.Extending, using the contributed extensions library

XMonad.Doc.Developing, introduction to xmonad internals and writing your own extensions.

xmonad-contrib

Community-maintained extensions for the XMonad window manager.

xmonad core is minimal, stable, yet extensible. xmonad-contrib is home to hundreds of additional tiling algorithms and extension modules. The two combined make for a powerful X11 window-manager with endless customization possibilities. They are, quite literally, libraries for creating your own window manager.

Installation

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 our documentation or ask the community for help.

Contributing

We welcome all forms of contributions:

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

Please do read the CONTRIBUTING document for more information about bug reporting and code contributions. For a brief overview of the architecture and code conventions, see the documentation for the XMonad.Doc.Developing module. If in doubt, talk to us.

License

Code submitted to the xmonad-contrib repo is licensed under the same license as xmonad core itself, with copyright held by the authors.