SUBTLE(1)																 SUBTLE(1)

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  win-
       dows to virtual desktops (called views) with matching tags, regardless of the current active view.

OPTIONS

       o   -c, --config=CONFIG
	   Load config

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

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

       o   -k, --check
	   Check config syntax

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

       o   -r, --replace
	   Replace current window manager

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

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

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

       o   -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.

       o   subtle -l ruby,subtlext

       o   subtle --level=ruby,subtlext

       Default levels:

       o   warnings Warning messages

       o   sublet Sublet warnings

       o   error Error messages

       o   deprecated Deprecation warnings

       Debugging levels:

       o   events Information about handled events

       o   ruby Ruby debugging messages

       o   xerror X11 error messages

       o   subtlext Debugging messages of subtlext

       o   subtle Subsystem messages of subtle

       o   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)