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

       ·   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>  <gravity> <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, ~ = resize, = = 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 result 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 argument.

           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)