unexist.dev

h1. What is subtle?

[[subtle]] is a *manual* tiling window manager with a rather uncommon approach of tiling: Instead of relying on predefined layouts, [[subtle]] divides the screen into a grid with customizeable slots (called [[gravity|gravities]]). For better understanding, the default [[config]] uses a 3x3 grid and maps each [[gravity]] to one key of the numpad. With those keys, [[Clients|windows]] can be moved directly to the desired [[gravity]] - the same can be done with [[tagging]] rules in the [[config]].

Another unique concept is the *strict* [[tagging]]: Unlike other tiling window managers, [[subtle]] doesn't allow *weak* [[tagging]] and always maps windows to virtual desktops (called [[views]]) with matching [[tagging|tags]], *regardless* of the current active [[views|view]].

h2. Features

* Builtin system tray

* Extendable builtin [[Panel|panel]] (see [[sublets]])

* Customizeable key/mouse actions (see [[Grabs|grabs]])

* Focus on scripting ("Ruby":http://www.ruby-lang.org - see "rdoc":http://rdoc.subforge.org and [[subtlext]])

* Commandline client (see [[subtler]])

* Extended window [[tagging]]

* Compliance ("EWMH":http://standards.freedesktop.org/wm-spec/wm-spec-1.3.html / "ICCCM":http://tronche.com/gui/x/icccm/ / "MWM":http://www.ist.co.uk/motif/books/vol6A/ch-20.fm.html / "XDG Base Directory":http://standards.freedesktop.org/basedir-spec/basedir-spec-0.6.html)

* Multihead support ("Xinerama":http://en.wikipedia.org/wiki/Xinerama / "XRandR":http://www.x.org/wiki/Projects/XRandR)

h2. Where to start?

{{subforge_column(:start)}}

* *Basics*

* [[Install|Installing subtle]]

* [[Usage|First steps]]

* [[Multihead|Using multihead]]

* [[Themes]]

* [[Blamelist]]

{{subforge_column(:mid)}}

* *In depth*

* [[Clients|Understanding clients]]

* [[Views|Understanding views]]

* [[Tagging|Understanding tagging]]

* [[Gravity|Understanding gravity]]

{{subforge_column(:mid)}}

* *Customizing*

* [[Config|Configuring subtle]]

* [[Styles|Setting up styles]]

* [[Grabs|Configuring keys]]

* [[Panel|Customizing panel]]

* [[Sublets|Installing sublets]]

{{subforge_column(:mid)}}

* *Hacking*

* [[Hacking|Hacking subtle]]

* [[Writing_sublets|Writing sublets]]

* [[Hooks|Hooking events]]

* [[Snippets]]

{{subforge_column(:mid)}}

* *Problems?*

* Check the [[FAQ]]

* Use the "bugtracker":http://subforge.org/projects/subtle/issues

* Ask in the "forum":http://subforge.org/projects/subtle/boards

* Join *#subtle* on *irc.freenode.org* (IRC)

{{subforge_column(:end)}}

h2. Contribute

In case you want to help but don't know how, please help with some documentation and improve the wiki or make a donation. Patches, suggestions and open discussions are always welcome.

h2. License

This code can be distributed under the terms of the "GNU GPLv2":http://www.gnu.org/licenses/gpl-2.0.html. See the file "COPYING":http://subforge.org/projects/subtle/repository/entry/COPYING for details.

h2. Read more

"Freshmeat":http://freshmeat.net/projects/subtle, "Sourceforge":http://sourceforge.net/projects/subtle-wm/, "Archlinux Forum":http://bbs.archlinux.org/viewtopic.php?id=71783, "Gentoo Forum":http://forums.gentoo.org/viewtopic-t-825036.html, "Debian Forum":http://forums.debian.net/viewtopic.php?f=6&t=69597