Install\015\012\015\012{{>toc}}\015\012\015\012h2. Dependencies\015\012\015\012subtle has the following dependencies:\015\012\015\012# Ruby (>=1.9)\015\012# Rake (>=0.8)\015\012# X11 (>=6.8.2)\015\012\015\012And following optional gems for sur:\015\012\015\012# curb (>=0.5.1.0) (sur only)\015\012# archive-tar-minitar (>=0.5.2)\015\012# datamapper (>=0.9.11) (surserver only)\015\012# sinatra (>=0.9.4) (surserver only)\015\012\015\012h2. Versions\015\012\015\012Stable releases can be found here or if you are using one of the supported install select the proper way from below.\015\012\015\012h3. Distributions\015\012\015\012h4. Archlinux\015\012\015\012Currently there are two different packages available:\015\012\015\012* subtle (current stable)\015\012* subtle-hg (developer snapshot)\015\012\015\012The stable version is in community and can be installed with pacman, the developer snapshot is in AUR and needs either a special tool like yaourt, clyde or packer or can be installed manually.\015\012\015\012h4. Debian\015\012\015\012Since a package for Debian does not yet exist, you need to compile subtle to get it up and running.\015\012\015\012# Install the dependencies with apt-get: libx11-dev, rake1.9.1, ruby1.9.1, ruby1.9.1-dev, pkg-config\015\012\015\012

sudo apt-get install libx11-dev rake1.9.1 ruby1.9.1 ruby1.9.1-dev pkg-config

\015\012# (Optional) Install optional dependencies for RandR, Xft, Xinerama, and Xpm with apt-get: libxrandr-dev, libxft-dev, libxinerama-dev, libxpm-dev\015\012

sudo apt-get install libxrandr-dev libxft-dev libxinerama-dev libxpm-dev

\015\012# Download either the latest stable package or clone the Mercurial repository\015\012# Change dir into the subtle folder (stable or latest) and issue rake: (rake1.9.1 for the latest version):\015\012\015\012

rake1.9

\015\012\015\012 This should configure and get you ready for install\015\012# Issue the following command to install it:\015\012\015\012

sudo rake1.9.1 install

\015\012\015\012h4. Exherbo\015\012\015\012Make sure to update jedahan's repository cave resolve -x jedahan\015\012\015\012Then install subtle like so\015\012\015\012 cave resolve -x subtle\015\012\015\012h4. Gentoo\015\012\015\012Currently there are two different overlays:\015\012\015\012Both are available via github# https://github.com/damex/subtle-overlay (This one is also available via layman, layman userguide# https://github.com/shurizzle/shura-overlay/tree/subtle\015\012\015\012h4. Ubuntu\015\012\015\012Since a package for Ubuntu does not yet exist, you need to compile subtle to get it up and running.\015\012\015\012_Note that these instructions are tested on Mavrick (10.10)_\015\012\015\012# Install the dependencies with apt-get: libx11-dev, ruby1.9.1, ruby1.9.1-dev, libruby1.9.1 and rake\015\012\015\012

sudo apt-get install libx11-dev rake ruby1.9.1 ruby1.9.1-dev libruby1.9.1

\015\012# Download either the latest stable package or clone the Mercurial repository\015\012# Change dir into the subtle folder (stable or latest) and issue rake: (rake1.9.1 for the latest version):\015\012\015\012

rake1.9.1

\015\012\015\012 This should configure and get you ready for install\015\012# Issue the following command to install it:\015\012\015\012

sudo rake1.9.1 install

\015\012# Add a subtle session to your xsessions:\015\012\015\012

sudo nano /usr/share/xsessions/subtle.desktop

\015\012\015\012 And add this:\015\012\015\012

[Desktop Entry]\015\012Encoding=UTF-8\015\012Name=subtle\015\012Comment=subtle tiling window manager\015\012Exec=subtle\015\012Type=XSession

\015\012# Reboot and enjoy subtle\015\012\015\012In case you are using PulseAudio and want to start subtle just via your .xinitrc you need to add following to it to get working audio:\015\012\015\012

exec ck-launch-session subtle

\015\012\015\012h3. Developer version\015\012\015\012If you like you can clone the Mercurial repository and install the latest developer version as followed:\015\012\015\012# hg clone http://hg.subforge.org/subtle\015\012# cd subtle\015\012# rake [options]\015\012# rake install\015\012\015\012The installer will copy the files to following XDG default path: (see: rake help)\015\012\015\012| Binaries | /usr/bin |\015\012| Config | /etc/xdg/subtle |\015\012| Extension | (Ruby Dir)/subtle |\015\012\015\012The paths can be easily changed (see: rake help) and are printed after configuring is done. subtle will create cache files to keep track of the settings, whenever you need to change a path later you need to delete the old caches with rake clobber.\015\012\015\012h2. Debug\015\012\015\012To enable debugging messages and levels, subtle must be compiled with debugging support. Since there is usually no debugging package available, it needs to be compiled manually:\015\012\015\012# hg clone http://hg.subforge.org/subtle\015\012# cd subtle\015\012# rake debug=yes\015\012# rake install\015\012\015\012subtle can be run directly from the source directory and there is no need to install it system wide, just add it to e.g. your ~/.xinitrc.\015\012¶