SUBTLER(1)																SUBTLER(1)

NAME

       subtler - a commandline interface for subtle

SYNOPSIS

       subtler [GENERIC|MODIFIER] GROUP ACTION [ARG1] [ARG2]

DESCRIPTION

       subtler	is  a  commandline  tool, that allows interacting with a EWMH/NetWM compatible window manager and especially with subtle(1) from a
       shell.

       The arguments of subtler are quite complex and allow a variety of spellings and different number of arguments. Most of the commands require
       at least one argument and return output of following format:

FORMAT

INPUT

       o   DISPLAY :<display number>

       o   ID <number>

       o   GEOMETRY <x>x<y>+<width>+<height>

       o   NAME <string|number>

       o   DATA <string|number>

       o   PATTERN
	   Matching works either via plaintext, regex(7), id or window id if applicable. If a pattern matches more than once ALL matches are used.

	   If the PATTERN is - subtler will read from stdin.

OUTPUT

       o   Client listing <window id> <visibility> <view id> <geometry> <gravity> <flags> <instance name> (<class name>)

       o   Gravity listing <gravity id> <geometry>

       o   Screen listing <screen id> <geometry>

       o   Tag listing <tag name>

       o   Tray listing <window id> <instance name> (<class name>)

       o   View listing <window id> <visibility> <view id> <view name>

FIELDS

       o   <window id> Numeric (hex) id (e.g. 0xa00009)

       o   <visibility> - = not visible, * = visible

       o   <view id> Numeric id (e.g. 5)

       o   <geometry> x x y + width + height

       o   <flags> - = not set, + = fullscreen, ^ = float, * = stick, ~ = resize, = = zaphod, ! = fixed

       o   <instance name> Window instance/resource name

       o   <class name> Window class name

       o   <gravity id> Numeric id of gravity (e.g. 2)

       o   <screen id> Numeric id of a screen (e.g. 1)

       o   <tag name> Name of a tag (e.g. terms)

OPTIONS

GENERIC

       o   -d, --display=DISPLAY
	   Connect to DISPLAY (default: :0)

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

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

       o   -p, --proc
	   This creates a ruby proc from the given argument and yields the result of the group to it as parameter param.

	   Examples:

	   subtler -cl -p "puts param.name"
	   subtler -cC -p "param.gravity = { terms: :left }"

MODIFIER

       o   -r, --reload
	   Reload subtle

       o   -R, --restart
	   Restart subtle

       o   -q, --quit
	   Quit subtle

       o   -C, --current
	   Select current active window/view instead of passing it via argument.

	   Example: subtler -cCf

       o   -X, --select
	   Select a window via pointer instead of passing it via argument.

	   Example: subtler -cXf

GROUPS

       o   -c, --Client
	   Use client group

       o   -g, --Gravity
	   Use gravity group

       o   -e, --Screen
	   Use screen group

       o   -s, --Sublet
	   Use sublet group

       o   -t, --Tag
	   Use tag group

       o   -y, --Tray
	   Use tray group

       o   -v, --View
	   Use views group

ACTIONS FOR CLIENTS

       o   -f, --find => PATTERN
	   Find client

	   Example: subtler -cf urxvt

       o   -o, --focus => PATTERN
	   Set focus to client

	   Example: subtler -co urxvt

       o   -F, --full => PATTERN
	   Toggle full

	   Example: subtler -cF urxvt

       o   -O, --float => PATTERN
	   Toggle float

	   Example: subtler -cO urxvt

       o   -S, --stick => PATTERN
	   Toggle stick

	   Example: subtler -cS urxvt

       o   -N, --urgent => PATTERN
	   Toggle urgent

	   Example: subtler -cN urxvt

       o   -l, --list
	   List all clients

       o   -T, --tag => PATTERN
	   Add tag to client

	   Example: subtler -cT urxvt tag

       o   -U, --untag => PATTERN NAME
	   Remove tag from client

	   Example: subtler -cU urxvt tag

       o   -G, --tags => PATTERN
	   Show client tags

	   Example: subtler -cG urxvt

       o   -Y, --gravity => PATTERN PATTERN
	   Set client gravity

	   Example: subtler -cY urxvt gravity

       o   -E, --raise => PATTERN
	   Raise client window

	   Example: subtler -cE urxvt

       o   -L, --lower => PATTERN
	   Lower client window

	   Example: subtler -cL urxvt

       o   -k, --kill => PATTERN
	   Kill client

	   Example: subtler -ck urxvt

ACTIONS FOR GRAVITIES

       o   -a, --add => NAME GEOMETRY
	   Create new gravity

	   Example: subtler -ga test 0x0+100+100

       o   -l, --list
	   List all gravities

	   Example: subtler -gl

       o   -f, --find => PATTERN
	   Find a gravity

	   Example: subtler -gf center

       o   -k, --kill => PATTERN
	   Kill gravity

	   Example: subtler -gk center

ACTIONS FOR SCREENS

       o   -l, --list
	   List all screens

	   Example: subtler -el

       o   -f, --find => ID
	   Find a screen

	   Example: subtler -ef 0

ACTIONS FOR SUBLETS

       o   -l, --list
	   List all sublets

	   Example: subtler -sl

       o   -f, --find => PATTERN
	   Find sublet

	   Example: subtler -sf sublet

       o   -u, --update
	   Updates value of sublet

	   Example: subtler -su

       o   -D, --data => PATTERN DATA
	   Send data to sublet

	   Example: subtler -sD sublet something

       o   -k, --kill => PATTERN
	   Kill sublet

	   Example: subtler -sk PATTERN

ACTIONS FOR TAGS

       o   -a, --add => NAME
	   Create new tag

	   Example: subtler -ta tag

       o   -f, --find => PATTERN
	   Find all clients/views by tag

	   Example: subtler -ta tag

       o   -l, --list
	   List all tags

	   Example: subtler -tl

       o   -I, --clients
	   Show clients with tag

	   Example: subtler -tI

       o   -k, --kill => PATTERN
	   Kill tag

	   Example: subtler -tk PATTERN

ACTIONS FOR TRAYS

       o   -f, --find => PATTERN
	   Find a tray

	   Example: subtler -yf PATTERN

       o   -l, --list
	   List all trays

	   Example: subtler -yl

       o   -k, --kill => PATTERN
	   Kill tray

	   Example: subtler -yk PATTERN

ACTIONS FOR VIEWS

       o   -a, --add => NAME
	   Create new view

	   Example: subtler -va NAME

       o   -f, --find => PATTERN
	   Find a view

	   Example: subtler -vf PATTERN

       o   -l, --list
	   List all views

	   Example: subtler -vl

       o   -T, --tag => PATTERN NAME
	   Add tag to view

	   Example: subtler -vT terms tag

       o   -U, --untag => PATTERN NAME
	   Remove tag from view

	   Example: subtler -vT terms tag

       o   -G, --tags
	   Show view tags

	   Example: subtler -vG terms

       o   -I, --clients
	   Show clients on view

	   Example: subtler -vI terms

       o   -k, --kill => PATTERN
	   Kill view

	   Example: subtler -vk terms

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), subtlext(1), sur(1), surserver(1)

								   November 2011							SUBTLER(1)