# xmonad-contrib **Community-maintained extensions for the [XMonad][web:xmonad] window manager.** [xmonad core][gh:xmonad] is minimal, stable, yet extensible. [xmonad-contrib][gh: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. [web:xmonad]: https://xmonad.org/ [gh:xmonad]: https://github.com/xmonad/xmonad [gh:xmonad-contrib]: https://github.com/xmonad/xmonad-contrib ## Installation For installation and configuration instructions, please see: * [downloading and installing xmonad](https://xmonad.org/download.html) * [installing latest xmonad snapshot from git](https://xmonad.org/INSTALL.html) * [configuring xmonad](https://xmonad.org/TUTORIAL.html) ## Contributing Haskell code contributed to this repo should live under the appropriate subdivision of the `XMonad` namespace (currently includes `Actions`, `Config`, `Hooks`, `Layout`, `Prompt`, and `Util`). For example, to use the Grid layout, one would import: XMonad.Layout.Grid For further details, see the [documentation for the `XMonad.Doc.Developing` module][doc:developing], XMonad's [CONTRIBUTING][gh:xmonad:contributing] and the [xmonad website][web:xmonad]. [gh:xmonad:contributing]: https://github.com/xmonad/xmonad/blob/master/CONTRIBUTING.md [doc:developing]: https://xmonad.github.io/xmonad-docs/xmonad-contrib/XMonad-Doc-Developing.html ## License Code submitted to the xmonad-contrib repo is licensed under the same license as xmonad core itself, with copyright held by the authors.