Subtle

Version 121 (Christoph Kappel, 2011-08-09 22:32)

1 94 Christoph Kappel
h1. What is subtle?
2 1
3 120 Christoph Kappel
[[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]].
4 53 Christoph Kappel
5 120 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 (calles [[views]]) with the appropriate [[tagging|tags]] *regardless* of the current active [[views|view]].
6 70 Christoph Kappel
7 115 Christoph Kappel
{{column(:start, width: 40%; vertical-align: top)}}
8 112 Christoph Kappel
9 94 Christoph Kappel
h2. Features
10 1
11 1
* Builtin system tray
12 1
* Extendable [[Panel|panel]] (see [[sublets]])
13 1
* Customizeable key/mouse actions (see [[Grabs|grabs]])
14 97 Christoph Kappel
* Scriptable with "Ruby":http://www.ruby-lang.org (see "rdoc":http://rdoc.subforge.org and [[subtlext]])
15 1
* Commandline client (see [[subtler]])
16 1
* Window [[tagging]]
17 110 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 Base Directory":http://standards.freedesktop.org/basedir-spec/basedir-spec-0.6.html compliant
18 104 Christoph Kappel
* "Xinerama":http://en.wikipedia.org/wiki/Xinerama / "XRandR":http://www.x.org/wiki/Projects/XRandR support
19 112 Christoph Kappel
20 115 Christoph Kappel
{{column(:mid, width: 60%; 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 102 Christoph Kappel
* *Basics*
29 94 Christoph Kappel
* [[Install|Installing subtle]]
30 94 Christoph Kappel
* [[Usage|Using subtle]]
31 1
* [[Sublets|Using sublets]]
32 104 Christoph Kappel
* [[Multihead|Using multihead]]
33 94 Christoph Kappel
* [[Themes]]
34 94 Christoph Kappel
35 94 Christoph Kappel
{{column(:mid)}}
36 94 Christoph Kappel
37 102 Christoph Kappel
* *In depth*
38 119 Christoph Kappel
* [[Clients|Understanding clients]]
39 94 Christoph Kappel
* [[Tagging|Understanding tagging]]
40 1
* [[Gravity|Understanding gravity]]
41 110 Christoph Kappel
* [[Styles|Understanding styles]]
42 94 Christoph Kappel
* [[Panel|Customizing panel]]
43 94 Christoph Kappel
* [[Grabs|Configuring keys]]
44 94 Christoph Kappel
* [[Hooks|Hooking events]]
45 94 Christoph Kappel
46 94 Christoph Kappel
{{column(:mid)}}
47 94 Christoph Kappel
48 102 Christoph Kappel
* *Hacking*
49 106 Christoph Kappel
* [[Hacking|Hacking subtle]]
50 94 Christoph Kappel
* [[Writing_sublets|Writing sublets]]
51 94 Christoph Kappel
* [[Scripting]]
52 94 Christoph Kappel
* [[Snippets]]
53 1
* [[Blamelist]]
54 108 Christoph Kappel
55 108 Christoph Kappel
{{column(:mid)}}
56 108 Christoph Kappel
57 108 Christoph Kappel
* *Problems*
58 108 Christoph Kappel
* "Frequently asked..":http://subforge.org/ezfaq/index/subtle
59 108 Christoph Kappel
* [[bugs|Reporting a bug]]
60 94 Christoph Kappel
61 94 Christoph Kappel
{{column(:end)}}
62 94 Christoph Kappel
63 121 Christoph Kappel
{{column(:start)}}
64 121 Christoph Kappel
65 94 Christoph Kappel
h2. Contribute
66 1
67 72 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.
68 1
69 121 Christoph Kappel
{{pledgie}}
70 111 Christoph Kappel
71 1
{{column(:mid)}}
72 116 Christoph Kappel
73 111 Christoph Kappel
h2. Problems?
74 93 Christoph Kappel
75 1
* Join *#subtle* on *irc.freenode.org* (IRC)
76 93 Christoph Kappel
* Use the "bugtracker":http://subforge.org/projects/subtle/issues
77 94 Christoph Kappel
* Ask in the "forum":http://subforge.org/projects/subtle/boards
78 121 Christoph Kappel
* Drop a mail to _chkappel_ at _subforge_ dot _org_
79 92 Christoph Kappel
80 121 Christoph Kappel
{{column(:end)}}
81 109 Christoph Kappel
82 109 Christoph Kappel
h2. License
83 109 Christoph Kappel
84 109 Christoph Kappel
This code can be distributed under the terms of the GNU GPLv2. See the file COPYING for details.
85 109 Christoph Kappel
86 94 Christoph Kappel
h2. Read more
87 93 Christoph Kappel
88 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