Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 ap-
       proach of tiling: Instead of relying on predefined layouts, subtle  di-
       vides  the  screen  into	a grid with customizeable slots	(called	gravi-
       ties). 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  win-
       dow 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 sup-
       ply one you are welcome.

       Next step after installing is configuring. subtle follows the XDG spec-
       ifications, 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  for-
       ward, 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=subtle&sektion=1&manpath=FreeBSD+Ports+15.0.quarterly>

home | help