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 the following optional gem dependencies for sur:\015\012\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\012\015\012h2. Versions\015\012\015\012If you are using one of the supported distributions, you can follow the appropriate installation instructions below to install the stable version of subtle or you can choose to follow the directions at the end of the page to install the latest development version.\015\012\015\012* Stable releases are available on this site's file download page* Development versions can be found in subtle's Mercurial respository. This repo is available for read-only hg access at http://hg.subforge.org/subtle and is browseable on the web here. Distributions\015\012\015\012h3. 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\012h3. Debian\015\012\015\012Since a pre-compiled 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\012yet\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\012h3. 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\012h3. 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\012h3. Ubuntu\015\012\015\012_Tested on Ubuntu Maverick (10.10) and Natty (11.04)_\015\012\015\012Since a pre-compiled package for Ubuntu doesn't exist yet, you will need to compile subtle to get it up and running.\015\012\015\012# Install subtle's dependencies (libx11-dev, ruby1.9.1, ruby1.9.1-dev, libruby1.9.1 and rake) using apt-get: \015\012\015\012

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

\015\012# Download the latest archive from the files page, and extract its contents:\015\012\015\012

\015\012      curl -O http://subforge.org/attachments/download/50/subtle-0.9.2773-mu.tbz2\015\012      tar xvf subtle-0.9.2773-mu.tbz2\015\012  

\015\012 Note that the current version number may differ from that shown in these example commands, so make sure you visit the files section to get the latest and greatest version/filename.\015\012# Now go in the newly created folder and run rake (rake1.9.1 to use the latest version), which will configure and prepare subtle for installation:\015\012\015\012

\015\012    cd subtle-0.9.2773-mu/\015\012    rake1.9\015\012  

\015\012# Issue the following command to install subtle:\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

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

\015\012# Finally, reboot and enjoy subtle!\015\012\015\012h5. Note for PulseAudio users\015\012\015\012If you are using PulseAudio and want to start subtle using just your xinitrc, you can get working audio by adding the following line to your .xinitrc file:\015\012\015\012

exec ck-launch-session subtle

\015\012\015\012h2. Install Development Version\015\012\015\012You can install the current development version of subtle by cloning and installing from the Mercurial subtle repository# hg clone http://hg.subforge.org/subtle\015\012# cd subtle\015\012# rake [options]\015\012# sudo 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, so whenever you need to change a path later you will need to delete the old caches by running rake clobber.\015\012\015\012h3. Debugging\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 with no need to install it system-wide, just add it to e.g. your ~/.xinitrc.\015\012¶