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)
