unexist.dev

h1. Welcome!\015\012\015\012This is the project site of the Open Source project [[subtle]]. The [[quickstart|documentation]], "forum":http://unexist.scrapping.cc/projects/subtle/boards and a "bug tracking system":http://unexist.scrapping.cc/projects/subtle/issue can be found here.\015\012\015\012h1. What is subtle?\015\012\015\012[[Subtle|subtle]] is a grid-based manual tiling window manager with a strong focus on easy but customizable look and feel. In comparison to other tiling windows managers, [[subtle]] has no automatic tiling of the screen size in any way, instead windows are arranged according to positions inside of a grid - these positions are called [[Gravity|gravities]].\015\012\015\012For better understanding of [[Gravity|gravities]], the layout of the grid is per default oriented on the numpad but can be changed in the [[config]]. That means that the 5 on the numpad is center, the 7 the upper left corner and so on. The [[gravity]] of a window can be changed with the _:WindowGravity_ [[Grabs|grab]], which is *Win+Numpad number*.\015\012\015\012[[Views]], virtual desktops in [[subtle]], show only windows with matching [[tags]]. Both windows and [[views]] can be tagged either in the [[config]] or via [[subtler]] and [[subtlext]]. [[Tags|Tagging]] is *mandatory*, without a matching [[Tags|tag]] a window will never appear on a certain [[Views|view]].\015\012\015\012h2. Features\015\012\015\012* Builtin system tray\015\012* Flexible [[Panel|panel]] (see also [[Sublets|sublets]])\015\012* Customizeable key/mouse actions (see [[Grabs|grabs]])\015\012* Scriptable with "Ruby":http://www.ruby-lang.org (see "rdoc":http://unexist.scrapping.cc/rdoc/subtle/index.html, [[Config|config]], [[Grabs|grabs]], [[Hooks|hooks]], [[Sublets|sublets]])\015\012* [[Tag|Window tagging]]\015\012* "EWMH":http://standards.freedesktop.org/wm-spec/wm-spec-1.3.html / "ICCCM":http://tronche.com/gui/x/icccm/ / "XDG":http://standards.freedesktop.org/basedir-spec/basedir-spec-0.6.html compliant\015\012* "Xinerama":http://en.wikipedia.org/wiki/Xinerama / "XRandr":http://www.x.org/wiki/Projects/XRandR support\015\012\015\012h2. Where to start?\015\012\015\012To get started with [[subtle]] just follow the [[Install|install instructions]], have a look in the @INSTALL@ file in the tarball or check if there is a package for your distribution. If no package is available and you want to supply one you are welcome. \015\012\015\012Next step after installing is configuring. [[Subtle]] follows the "XDG specifications":http://standards.freedesktop.org/basedir-spec/basedir-spec-0.6.html, therefore can the default system config be found in @$XDG_CONFIG_DIRS/subtle@ or in @/etc/xdg/subtle@. If you prefer a user based config just copy the system config to @$XDG_CONFIG_HOME/subtle@ or to @$HOME/.config/subtle@. \015\012\015\012_If you update the config please check it with *subtle -k* first before starting [[subtle]]._\015\012\015\012Inside of [[subtle]] just press *Win+Return* to launch a xterm which usually starts at center [[gravity]]. Once you have a client you can play with [[gravity|gravites]] to get used to the system. It's really easy and straight forward, just try the various combinations of *Win+Numpad number*.\015\012\015\012h2. Getting subtle\015\012\015\012The current stable version of [[Subtle|subtle]] is *0.8.1602* and is available for "download":http://unexist.scrapping.cc/projects/list_files/subtle. If you prefer bleeding edge you can check out the latest version from the "Mercurial":http://www.selenic.com/mercurial/ repository or download the recent "tip":http://hg.scrapping.cc/subtle/archive/tip.tar.bz2.\015\012\015\012bq. hg clone http://hg.scrapping.cc/subtle\015\012\015\012_Keep in mind that the developer version in the repository is under heavily development and may or may not work._\015\012\015\012h2. Build packages\015\012\015\012"Archlinux":http://www.archlinux.org: "subtle":http://aur.archlinux.org/packages.php?do_Details=1&ID=13016, "subtle-hg":http://aur.archlinux.org/packages.php?ID=13139\015\012"Exherbo":http://git.exherbo.org/summer/packages/x11-wm/subtle/\015\012"Gentoo":http://bugs.gentoo.org/show_bug.cgi?id=280043\015\012\015\012h2. Links\015\012\015\012"Rubyforge":http://rubyforge.org/projects/subtle/, "Freshmeat":http://freshmeat.net/projects/subtle, "Ohloh":https://www.ohloh.net/p/subtle, "Sourceforge":http://sourceforge.net/projects/subtle-wm/\015\012"Archlinux Wiki":http://wiki.archlinux.org, "Archlinux Forum":http://bbs.archlinux.org/viewtopic.php?id=71783\015\012\015\012h2. Contact\015\012\015\012If you have problems, suggestions or just want to talk about [[Subtle|subtle]] feel free to join *#subtle* on *irc.freenode.org*, drop a mail to _unexist_ at _dorfelite_ dot _net_.