Subtle

Version 134 (Christoph Kappel, 2011-09-02 20:02)

1 94 Christoph Kappel
h1. What is subtle?
2 1
3 130 Christoph Kappel
[[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]].
4 53 Christoph Kappel
5 131 Christoph Kappel
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]].
6 70 Christoph Kappel
7 132 Christoph Kappel
{{column(:start, width: 50%; vertical-align: top)}}
8 112 Christoph Kappel
9 94 Christoph Kappel
h2. Features
10 1
11 1
* Builtin system tray
12 132 Christoph Kappel
* Extendable builtin [[Panel|panel]] (see [[sublets]])
13 1
* Customizeable key/mouse actions (see [[Grabs|grabs]])
14 132 Christoph Kappel
* Focus on scripting ("Ruby":http://www.ruby-lang.org - see "rdoc":http://rdoc.subforge.org and [[subtlext]])
15 1
* Commandline client (see [[subtler]])
16 132 Christoph Kappel
* Extended window [[tagging]]
17 132 Christoph Kappel
* 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)
18 133 Christoph Kappel
* Multihead support ("Xinerama":http://en.wikipedia.org/wiki/Xinerama / "XRandR":http://www.x.org/wiki/Projects/XRandR)
19 112 Christoph Kappel
20 132 Christoph Kappel
{{column(:mid, width: 50%; background: url(/images/subtlebw.png) right center no-repeat)}}
21 112 Christoph Kappel
22 112 Christoph Kappel
{{column(:end)}}
23 93 Christoph Kappel
24 94 Christoph Kappel
h2. Where to start?
25 94 Christoph Kappel
26 94 Christoph Kappel
{{column(:start)}}
27 94 Christoph Kappel
28 94 Christoph Kappel
* *Basics*
29 1
* [[Install|Installing subtle]]
30 130 Christoph Kappel
* [[Usage|First steps]]
31 1
* [[Multihead|Using multihead]]
32 104 Christoph Kappel
* [[Themes]]
33 130 Christoph Kappel
* [[Blamelist]]
34 94 Christoph Kappel
35 1
{{column(:mid)}}
36 94 Christoph Kappel
37 1
* *In depth*
38 1
* [[Clients|Understanding clients]]
39 130 Christoph Kappel
* [[Views|Understanding views]]
40 1
* [[Tagging|Understanding tagging]]
41 1
* [[Gravity|Understanding gravity]]
42 130 Christoph Kappel
43 130 Christoph Kappel
{{column(:mid)}}
44 130 Christoph Kappel
45 130 Christoph Kappel
* *Customizing*
46 130 Christoph Kappel
* [[Styles|Setting up styles]]
47 94 Christoph Kappel
* [[Grabs|Configuring keys]]
48 130 Christoph Kappel
* [[Panel|Customizing panel]]
49 130 Christoph Kappel
* [[Sublets|Installing sublets]]
50 94 Christoph Kappel
51 94 Christoph Kappel
{{column(:mid)}}
52 102 Christoph Kappel
53 106 Christoph Kappel
* *Hacking*
54 94 Christoph Kappel
* [[Hacking|Hacking subtle]]
55 94 Christoph Kappel
* [[Writing_sublets|Writing sublets]]
56 130 Christoph Kappel
* [[Hooks|Hooking events]]
57 1
* [[Snippets]]
58 108 Christoph Kappel
59 108 Christoph Kappel
{{column(:mid)}}
60 108 Christoph Kappel
61 123 Christoph Kappel
* *Problems?*
62 123 Christoph Kappel
* Check the "FAQ":http://subforge.org/ezfaq/index/subtle
63 1
* Use the "bugtracker":http://subforge.org/projects/subtle/issues
64 1
* Ask in the "forum":http://subforge.org/projects/subtle/boards
65 126 Christoph Kappel
* Join *#subtle* on *irc.freenode.org* (IRC)
66 111 Christoph Kappel
67 93 Christoph Kappel
{{column(:end)}}
68 122 Christoph Kappel
69 122 Christoph Kappel
h2. Contribute
70 122 Christoph Kappel
71 122 Christoph Kappel
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.
72 122 Christoph Kappel
73 122 Christoph Kappel
{{pledgie}}
74 109 Christoph Kappel
75 109 Christoph Kappel
h2. License
76 109 Christoph Kappel
77 129 Christoph Kappel
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.
78 109 Christoph Kappel
79 94 Christoph Kappel
h2. Read more
80 93 Christoph Kappel
81 134 Christoph Kappel
"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, "Debian Forum":http://forums.debian.net/viewtopic.php?f=6&t=69597