subtle

h1. What is subtle?

[[subtle]] is a *manual* tiling window manager with a rather uncommon approach of tiling: Instead of a bunch of predefined layouts, windows are placed on customizeable positions (called [[gravity|gravities]]) inside of a grid. The user can freely modify [[gravity]] definitions and assign [[gravity|gravities]] to windows either manually or via [[tagging|tags]] 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 (calles [[views]]) with the appropriate [[tagging|tags]] *regardless* of the current active [[views|view]].

{{column(:start, width: 40%; vertical-align: top)}}

h2. Features

* Builtin system tray

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

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

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

* Commandline client (see [[subtler]])

* Window [[tagging]]

* "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 compliant

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

{{column(:mid, width: 60%; background: url(/images/subtlebw.png) right center no-repeat)}}

{{column(:end)}}

h2. Where to start?

{{column(:start)}}

* *Basics*

* [[Install|Installing subtle]]

* [[Usage|Using subtle]]

* [[Sublets|Using sublets]]

* [[Multihead|Using multihead]]

* [[Themes]]

{{column(:mid)}}

* *In depth*

* [[Clients|Understanding clients]]

* [[Tagging|Understanding tagging]]

* [[Gravity|Understanding gravity]]

* [[Styles|Understanding styles]]

* [[Panel|Customizing panel]]

* [[Grabs|Configuring keys]]

* [[Hooks|Hooking events]]

{{column(:mid)}}

* *Hacking*

* [[Hacking|Hacking subtle]]

* [[Writing_sublets|Writing sublets]]

* [[Scripting]]

* [[Snippets]]

* [[Blamelist]]

{{column(:mid)}}

* *Problems?*

* Check the "FAQ":http://subforge.org/ezfaq/index/subtle

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

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

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

{{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.

{{pledgie}}

h2. License

This code can be distributed under the terms of the GNU GPLv2. See the file COPYING for details.

h2. Read more

"Ohloh":https://www.ohloh.net/p/subtle, "Rubyforge":http://rubyforge.org/projects/subtle/, "Freshmeat":http://freshmeat.net/projects/subtle, "Sourceforge":http://sourceforge.net/projects/subtle-wm/, "Archlinux Wiki":http://wiki.archlinux.org, "Archlinux Forum":http://bbs.archlinux.org/viewtopic.php?id=71783, "Gentoo Forum":http://forums.gentoo.org/viewtopic-t-825036.html