SUBTLER

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)