subtler - Online in the Cloud

PROGRAM:

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

Use subtler online using onworks.net services