What is it?
-----------

herbstluftwm is a manual tiling window manager for X11 using Xlib and Glib.
Its main features can be described with:

  * the layout is based on splitting frames into subframes which can be split
    again or can be filled with windows (similar to
    link:http://i3wm.org/[i3]/
    or musca)

  * tags (or workspaces or virtual desktops or ...) can be added/removed at
    runtime. Each tag contains an own layout

  * exactly one tag is viewed on each monitor. The tags are monitor independent
    (similar to link:http://xmonad.org/[xmonad])

  * it is configured at runtime via ipc calls from herbstclient. So the
    configuration file is just a script which is run on startup. (similar to
    link:http://wmii.suckless.org/[wmii] or musca)

How to get it?
--------------
Install it via the package manager, link:download.html[download tarballs], or
clone the link:http://github.com/herbstluftwm/herbstluftwm[git repository]:

----
git clone https://github.com/herbstluftwm/herbstluftwm
----

How to use it?
---------------
If you are new to herbstluftwm, the link:tutorial.html[tutorial] is the best
place to start.

There are manpages for link:herbstluftwm.html[herbstluftwm] and
link:herbstclient.html[herbstclient] in the +doc/+ directory. They also can be
seen link:herbstluftwm.html[online].

Support
-------
You are welcome to join the IRC channel +#herbstluftwm+ on +irc.freenode.net+.

For further bug reporting or patch submission contact the mailing list:
----
hlwm@lists.herbstluftwm.org
----
You can subscribe by sending a mail with the subject +subscribe+ to
+hlwm-request@lists.herbstluftwm.org+ or by using the
link:https://lists.schokokeks.org/mailman/listinfo.cgi/hlwm[Mailman
web interface].

Screenshots
-----------
// these screenshots are not in the git repo, so they must exist in the target
// directory
image:img/irc-layout-tab-thumb.png["scr",link="img/irc-layout-tab.png"]
image:img/herbstluftwm-autumncolors-thumb.png["scr",link="img/herbstluftwm-autumncolors.png"]
image:img/hlwm-panelicons-0-thumb.png["scr",link="img/hlwm-panelicons-0.png"]
image:img/hlwm-panelicons-1-thumb.png["scr",link="img/hlwm-panelicons-1.png"]
image:img/hlwm-pseudotile-1-thumb.png["scr",link="img/hlwm-pseudotile-1.png"]

// vim: nowrap
