Project

General

Profile

Subtle » History » Version 142

Christoph Kappel, 01/23/2018 03:11 PM

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