NAME

       subtle - a grid-based manual tiling window manager

SYNOPSIS

       subtle OPTIONS

DESCRIPTION

       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.

OPTIONS

       •   -c, --config=CONFIG
           Load config

       •   -d, --display=DISPLAY
           Connect to DISPLAY

       •   -h, --help
           Show this help and exit

       •   -k, --check
           Check config syntax

       •   -n, --no-randr
           Disable RandR extension (required for Twinview)

       •   -r, --replace
           Replace current window manager

       •   -s, --sublets=DIR
           Load sublets from DIR

       •   -v, --version
           Show version info and exit

       •   -l, --level=LEVEL[,LEVEL] Set logging levels

       •   -D, --debug
           Print debugging messages

LOGLEVELS

       subtle uses a loglevel system to distinguish between messages  and  to  be  able  to  turn
       certain  messages  off.  The  level  can  be set with the -l or --level= options, multiple
       values are comma separated without any whitespace.

       •   subtle -l ruby,subtlext

       •   subtle --level=ruby,subtlext

       Default levels:

       •   warnings Warning messages

       •   sublet Sublet warnings

       •   error Error messages

       •   deprecated Deprecation warnings

       Debugging levels:

       •   events Information about handled events

       •   ruby Ruby debugging messages

       •   xerror X11 error messages

       •   subtlext Debugging messages of subtlext

       •   subtle Subsystem messages of subtle

       •   debug General debugging messages

GETTING STARTED

       To get started with subtle just follow the  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.

       Next step  after  installing  is  configuring.  subtle  follows  the  XDG  specifications,
       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.

       If you update the config please check it with subtle -k first before starting subtle.

       Inside  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 gravites to get used to the system. It´s
       really easy and straight forward, just try the various combinations of Win+Numpad number.

BUGS

       Report bugs at http://subforge.org/projects/subtle/issues
       Homepage: http://subtle.subforge.org

COPYRIGHT

       Copyright (c) Christoph Kappel unexist@subforge.org

SEE ALSO

       subtle(1), subtler(1), subtlext(1), sur(1), surserver(1)

                                           October 2011                                 SUBTLE(1)