--- name: "subtler" section: "1" platform: "linux" package: "subtle" version: "0.11.3224-xi-2.2+b8" release: "Debian 12 (Bookworm)" platforms: ["linux"] url: "https://new.carta.tech/subtler" --- # subtler(1) a commandline interface for subtle ## 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)](/subtle/1.md) 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** :\ - • **ID** \ - • **GEOMETRY** \x\+\+\ - • **NAME** \ - • **DATA** \ - • **PATTERN**\ Matching works either via plaintext, [regex(7)](/regex/7.md), 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** \ \ \ \ \ \ \ (\) - • **Gravity listing** \ \ - • **Screen listing** \ \ - • **Tag listing** \ - • **Tray listing** \ \ (\) - • **View listing** \ \ \ \ - ## FIELDS - • \ Numeric (hex) id (e.g. 0xa00009) - • \ - = not visible, \* = visible - • \ Numeric id (e.g. 5) - • \ x x y + width + height - • \ - = not set, + = fullscreen, ^ = float, \* = stick, ~ = resize, = = zaphod, ! = fixed - • \ Window instance/resource name - • \ Window class name - • \ Numeric id of gravity (e.g. 2) - • \ Numeric id of a screen (e.g. 1) - • \ 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 \ ## SEE ALSO [subtle(1)](/subtle/1.md), [subtlext(1)](/subtlext/1.md), [sur(1)](/sur/1.md), [surserver(1)](/surserver/1.md)