unexist.dev

h1. What is subtle?

[[subtle]] subtle?\015\012\015\012[[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 [[config]].\015\012\015\012Another 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, [[views|view]].\015\012\015\012{{column(:start, width: 50%; vertical-align: top)}}

h2. Features

* top)}}\015\012\015\012h2. Features\015\012\015\012* Builtin system tray
* tray\015\012* Extendable builtin [[Panel|panel]] (see [[sublets]])
* [[sublets]])\015\012* Customizeable key/mouse actions (see [[Grabs|grabs]])
* [[Grabs|grabs]])\015\012* Focus on scripting ("Ruby":http://www.ruby-lang.org - see "rdoc":http://rdoc.subforge.org and [[subtlext]])
* [[subtlext]])\015\012* Commandline client (see [[subtler]])
* [[subtler]])\015\012* Extended window [[tagging]]
* [[tagging]]\015\012* 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)
* Directory":http://standards.freedesktop.org/basedir-spec/basedir-spec-0.6.html)\015\012* Multihead support ("Xinerama":http://en.wikipedia.org/wiki/Xinerama / "XRandR":http://www.x.org/wiki/Projects/XRandR)

{{subforge_column(:mid, "XRandR":http://www.x.org/wiki/Projects/XRandR)\015\012\015\012{{column(:mid, width: 50%; background: url(/images/subtlebw.png) center center no-repeat)}}

{{subforge_column(:end)}}

h2. no-repeat)}}\015\012\015\012{{column(:end)}}\015\012\015\012h2. Where to start?

{{subforge_column(:start)}}

* *Basics*
* start?\015\012\015\012{{column(:start)}}\015\012\015\012* *Basics*\015\012* [[Install|Installing subtle]]
* subtle]]\015\012* [[Usage|First steps]]
* steps]]\015\012* [[Multihead|Using multihead]]
* [[Themes]]
* [[Blamelist]]

{{subforge_column(:mid)}}

* multihead]]\015\012* [[Themes]]\015\012* [[Blamelist]]\015\012\015\012{{column(:mid)}}\015\012\015\012* *In depth*
* depth*\015\012* [[Clients|Understanding clients]]
* clients]]\015\012* [[Views|Understanding views]]
* views]]\015\012* [[Tagging|Understanding tagging]]
* tagging]]\015\012* [[Gravity|Understanding gravity]]

{{subforge_column(:mid)}}

* *Customizing*
* gravity]]\015\012\015\012{{column(:mid)}}\015\012\015\012* *Customizing*\015\012* [[Config|Configuring subtle]]
* subtle]]\015\012* [[Styles|Setting up styles]]
* styles]]\015\012* [[Grabs|Configuring keys]]
* keys]]\015\012* [[Panel|Customizing panel]]
* panel]]\015\012* [[Sublets|Installing sublets]]

{{subforge_column(:mid)}}

* *Hacking*
* sublets]]\015\012\015\012{{column(:mid)}}\015\012\015\012* *Hacking*\015\012* [[Hacking|Hacking subtle]]
* subtle]]\015\012* [[Writing_sublets|Writing sublets]]
* sublets]]\015\012* [[Hooks|Hooking events]]
* [[Snippets]]

{{subforge_column(:mid)}}

* *Problems?*
* events]]\015\012* [[Snippets]]\015\012\015\012{{column(:mid)}}\015\012\015\012* *Problems?*\015\012* Check the "FAQ":http://subforge.org/ezfaq/index/subtle
* "FAQ":http://subforge.org/ezfaq/index/subtle\015\012* Use the "bugtracker":http://subforge.org/projects/subtle/issues
* "bugtracker":http://subforge.org/projects/subtle/issues\015\012* Ask in the "forum":http://subforge.org/projects/subtle/boards
* "forum":http://subforge.org/projects/subtle/boards\015\012* Join *#subtle* on *irc.freenode.org* (IRC)

{{subforge_column(:end)}}

h2. Contribute

In (IRC)\015\012\015\012{{column(:end)}}\015\012\015\012h2. Contribute\015\012\015\012In 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.

{{subforge_pledgie}}

h2. License

This welcome.\015\012\015\012{{pledgie}}\015\012\015\012h2. License\015\012\015\012This 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. details.\015\012\015\012h2. Read more

"Freshmeat":http://freshmeat.net/projects/subtle, more\015\012\015\012"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, "Debian Forum":http://forums.debian.net/viewtopic.php?f=6&t=69597