|
|
MicroPlanet Gravity: Released : Gravity 2.7.1 Build 8
01-13-2009
|
|
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)