Subtle

Version 109 (Christoph Kappel, 2011-03-23 16:01)

1 94 Christoph Kappel
h1. What is subtle?
2 1
3 70 Christoph Kappel
[[subtle]] is a +manual+ tiling window manager with a rather uncommon approach of tiling: Per default there is no typical layout enforcement, windows are placed on a position ([[gravity]]) in a custom grid. The user can change the [[gravity]] of each window either directly per [[grabs]] or with rules defined by [[tagging|tags]] in the [[config]].
4 53 Christoph Kappel
5 1
Windows are visible on views - the virtual desktops in [[subtle]] - that have at least one [[tagging|tag]] in common.
6 70 Christoph Kappel
7 94 Christoph Kappel
h2. Features
8 1
9 1
* Builtin system tray
10 1
* Extendable [[Panel|panel]] (see [[sublets]])
11 1
* Customizeable key/mouse actions (see [[Grabs|grabs]])
12 97 Christoph Kappel
* Scriptable with "Ruby":http://www.ruby-lang.org (see "rdoc":http://rdoc.subforge.org and [[subtlext]])
13 1
* Commandline client (see [[subtler]])
14 1
* Window [[tagging]]
15 103 Christoph Kappel
* "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":http://standards.freedesktop.org/basedir-spec/basedir-spec-0.6.html compliant
16 104 Christoph Kappel
* "Xinerama":http://en.wikipedia.org/wiki/Xinerama / "XRandR":http://www.x.org/wiki/Projects/XRandR support
17 93 Christoph Kappel
18 94 Christoph Kappel
h2. Where to start?
19 94 Christoph Kappel
20 94 Christoph Kappel
{{column(:start)}}
21 94 Christoph Kappel
22 102 Christoph Kappel
* *Basics*
23 94 Christoph Kappel
* [[Install|Installing subtle]]
24 94 Christoph Kappel
* [[Usage|Using subtle]]
25 1
* [[Sublets|Using sublets]]
26 104 Christoph Kappel
* [[Multihead|Using multihead]]
27 94 Christoph Kappel
* [[Themes]]
28 94 Christoph Kappel
29 94 Christoph Kappel
{{column(:mid)}}
30 94 Christoph Kappel
31 102 Christoph Kappel
* *In depth*
32 94 Christoph Kappel
* [[Tagging|Understanding tagging]]
33 94 Christoph Kappel
* [[Gravity|Understanding gravity]]
34 94 Christoph Kappel
* [[Panel|Customizing panel]]
35 94 Christoph Kappel
* [[Grabs|Configuring keys]]
36 94 Christoph Kappel
* [[Hooks|Hooking events]]
37 94 Christoph Kappel
38 94 Christoph Kappel
{{column(:mid)}}
39 94 Christoph Kappel
40 102 Christoph Kappel
* *Hacking*
41 106 Christoph Kappel
* [[Hacking|Hacking subtle]]
42 94 Christoph Kappel
* [[Writing_sublets|Writing sublets]]
43 94 Christoph Kappel
* [[Scripting]]
44 94 Christoph Kappel
* [[Snippets]]
45 1
* [[Blamelist]]
46 108 Christoph Kappel
47 108 Christoph Kappel
{{column(:mid)}}
48 108 Christoph Kappel
49 108 Christoph Kappel
* *Problems*
50 108 Christoph Kappel
* "Frequently asked..":http://subforge.org/ezfaq/index/subtle
51 108 Christoph Kappel
* [[bugs|Reporting a bug]]
52 94 Christoph Kappel
53 94 Christoph Kappel
{{column(:end)}}
54 94 Christoph Kappel
55 94 Christoph Kappel
h2. Contribute
56 94 Christoph Kappel
57 96 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.
58 72 Christoph Kappel
59 72 Christoph Kappel
Unfinished pages:
60 72 Christoph Kappel
61 72 Christoph Kappel
* [[Usage]]
62 81 Christoph Kappel
* [[Sublets]]
63 78 Christoph Kappel
* [[Tagging]]
64 75 Christoph Kappel
* [[Gravity]]
65 92 Christoph Kappel
* [[Scripting]]
66 105 Christoph Kappel
* [[Multihead]]
67 93 Christoph Kappel
68 94 Christoph Kappel
h2. Problems?
69 1
70 93 Christoph Kappel
* Join *#subtle* on *irc.freenode.org* (IRC)
71 94 Christoph Kappel
* Use the "bugtracker":http://subforge.org/projects/subtle/issues
72 94 Christoph Kappel
* Ask in the "forum":http://subforge.org/projects/subtle/boards
73 92 Christoph Kappel
* Drop a mail to _unexist_ at _dorfelite_ dot _net_
74 93 Christoph Kappel
75 109 Christoph Kappel
76 109 Christoph Kappel
h2. License
77 109 Christoph Kappel
78 109 Christoph Kappel
This code can be distributed under the terms of the GNU GPLv2. See the file COPYING for details.
79 109 Christoph Kappel
80 94 Christoph Kappel
h2. Read more
81 93 Christoph Kappel
82 94 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