unexist.dev

h1. What is subtle?

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 gravities). For better understanding, the default config uses a 3x3 grid and maps each gravity to one key of the numpad. With those keys, windows can be moved directly to the desired gravity - the same can be done with tagging rules in the config.

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 tags, regardless of the current active view.

h2. Features

- Builtin system tray

- Extendable builtin panel (see sublets)

- Customizeable key/mouse actions (see grabs)

- Focus on scripting (Ruby - see rdoc and subtlext)

- Commandline client (see subtler)

- Extended window tagging

- Compliance (EWMH / ICCCM / MWM / XDG Base Directory)

- Multihead support (Xinerama / XRandR)

h2. Where to start?

{{subforge_column(:start)}}

* *Basics*

* [[Install|Installing subtle]]

* [[Usage|First steps]]

* [[Multihead|Using multihead]]

* [[Themes]]

* [[Blamelist]]

{{subforge_column(:mid)}}

* *In depth*

* [[Clients|Understanding clients]]

* [[Views|Understanding views]]

* [[Tagging|Understanding tagging]]

* [[Gravity|Understanding gravity]]

{{subforge_column(:mid)}}

* *Customizing*

* [[Config|Configuring subtle]]

* [[Styles|Setting up styles]]

* [[Grabs|Configuring keys]]

* [[Panel|Customizing panel]]

* [[Sublets|Installing sublets]]

{{subforge_column(:mid)}}

* *Hacking*

* [[Hacking|Hacking subtle]]

* [[Writing_sublets|Writing sublets]]

* [[Hooks|Hooking events]]

* [[Snippets]]

{{subforge_column(:mid)}}

* *Problems?*

* Check the [[FAQ]]

* Use the "bugtracker":http://subforge.org/projects/subtle/issues

* Ask in the "forum":http://subforge.org/projects/subtle/boards

{{subforge_column(:end)}}

h2. Contribute

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.

h2. License

This code can be distributed under the terms of the GNU GPLv3. See the file COPYING for details.