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

{{subforge_column(:start, width: 50%; vertical-align: top)}}

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)

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

{{subforge_column(:end)}}

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