FreeBSD Manual Pages
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 re- quire at least one argument and return output of following format: FORMAT INPUT • DISPLAY :<display number> • ID <number> • GEOMETRY <x>x<y>+<width>+<height> • NAME <string|number> • DATA <string|number> • 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 • Client listing <window id> <visibility> <view id> <geometry> <grav- ity> <flags> <instance name> (<class name>) • Gravity listing <gravity id> <geometry> • Screen listing <screen id> <geometry> • Tag listing <tag name> • Tray listing <window id> <instance name> (<class name>) • View listing <window id> <visibility> <view id> <view name> FIELDS • <window id> Numeric (hex) id (e.g. 0xa00009) • <visibility> - = not visible, * = visible • <view id> Numeric id (e.g. 5) • <geometry> x x y + width + height • <flags> - = not set, + = fullscreen, ^ = float, * = stick, ~ = re- size, = = zaphod, ! = fixed • <instance name> Window instance/resource name • <class name> Window class name • <gravity id> Numeric id of gravity (e.g. 2) • <screen id> Numeric id of a screen (e.g. 1) • <tag name> Name of a tag (e.g. terms) OPTIONS GENERIC • -d, --display=DISPLAY Connect to DISPLAY (default: :0) • -h, --help Show this help and exit • -V, --version Show version info and exit • -p, --proc This creates a ruby proc from the given argument and yields the re- sult of the group to it as parameter param. Examples: subtler -cl -p "puts param.name" subtler -cC -p "param.gravity = { terms: :left }" MODIFIER • -r, --reload Reload subtle • -R, --restart Restart subtle • -q, --quit Quit subtle • -C, --current Select current active window/view instead of passing it via argu- ment. Example: subtler -cCf • -X, --select Select a window via pointer instead of passing it via argument. Example: subtler -cXf GROUPS • -c, --Client Use client group • -g, --Gravity Use gravity group • -e, --Screen Use screen group • -s, --Sublet Use sublet group • -t, --Tag Use tag group • -y, --Tray Use tray group • -v, --View Use views group ACTIONS FOR CLIENTS • -f, --find => PATTERN Find client Example: subtler -cf urxvt • -o, --focus => PATTERN Set focus to client Example: subtler -co urxvt • -F, --full => PATTERN Toggle full Example: subtler -cF urxvt • -O, --float => PATTERN Toggle float Example: subtler -cO urxvt • -S, --stick => PATTERN Toggle stick Example: subtler -cS urxvt • -N, --urgent => PATTERN Toggle urgent Example: subtler -cN urxvt • -l, --list List all clients • -T, --tag => PATTERN Add tag to client Example: subtler -cT urxvt tag • -U, --untag => PATTERN NAME Remove tag from client Example: subtler -cU urxvt tag • -G, --tags => PATTERN Show client tags Example: subtler -cG urxvt • -Y, --gravity => PATTERN PATTERN Set client gravity Example: subtler -cY urxvt gravity • -E, --raise => PATTERN Raise client window Example: subtler -cE urxvt • -L, --lower => PATTERN Lower client window Example: subtler -cL urxvt • -k, --kill => PATTERN Kill client Example: subtler -ck urxvt ACTIONS FOR GRAVITIES • -a, --add => NAME GEOMETRY Create new gravity Example: subtler -ga test 0x0+100+100 • -l, --list List all gravities Example: subtler -gl • -f, --find => PATTERN Find a gravity Example: subtler -gf center • -k, --kill => PATTERN Kill gravity Example: subtler -gk center ACTIONS FOR SCREENS • -l, --list List all screens Example: subtler -el • -f, --find => ID Find a screen Example: subtler -ef 0 ACTIONS FOR SUBLETS • -l, --list List all sublets Example: subtler -sl • -f, --find => PATTERN Find sublet Example: subtler -sf sublet • -u, --update Updates value of sublet Example: subtler -su • -D, --data => PATTERN DATA Send data to sublet Example: subtler -sD sublet something • -k, --kill => PATTERN Kill sublet Example: subtler -sk PATTERN ACTIONS FOR TAGS • -a, --add => NAME Create new tag Example: subtler -ta tag • -f, --find => PATTERN Find all clients/views by tag Example: subtler -ta tag • -l, --list List all tags Example: subtler -tl • -I, --clients Show clients with tag Example: subtler -tI • -k, --kill => PATTERN Kill tag Example: subtler -tk PATTERN ACTIONS FOR TRAYS • -f, --find => PATTERN Find a tray Example: subtler -yf PATTERN • -l, --list List all trays Example: subtler -yl • -k, --kill => PATTERN Kill tray Example: subtler -yk PATTERN ACTIONS FOR VIEWS • -a, --add => NAME Create new view Example: subtler -va NAME • -f, --find => PATTERN Find a view Example: subtler -vf PATTERN • -l, --list List all views Example: subtler -vl • -T, --tag => PATTERN NAME Add tag to view Example: subtler -vT terms tag • -U, --untag => PATTERN NAME Remove tag from view Example: subtler -vT terms tag • -G, --tags Show view tags Example: subtler -vG terms • -I, --clients Show clients on view Example: subtler -vI terms • -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)
NAME | SYNOPSIS | DESCRIPTION | FORMAT | INPUT | OUTPUT | FIELDS | OPTIONS | GENERIC | MODIFIER | GROUPS | ACTIONS FOR CLIENTS | ACTIONS FOR GRAVITIES | ACTIONS FOR SCREENS | ACTIONS FOR SUBLETS | ACTIONS FOR TAGS | ACTIONS FOR TRAYS | ACTIONS FOR VIEWS | BUGS | COPYRIGHT | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=subtler&sektion=1&manpath=FreeBSD+Ports+15.0.quarterly>