cowiconman(1)

NAME

cowiconman - CoW Icon Manager

SYNOPSIS

cowiconman [--output NAME|@N|current|self]
[--desk N|current] [--page X,Y|current]
[--sort none|title|app|id]
[--group-by none|app|title|output|desk]
[--match FIELD=TEXT]
[--format FMT]
[--rows N] [--cols N] [--anchor none|top|bottom]
[--button-width N] [--min-button-width N]
[--iconified-marker] [--show-self]

DESCRIPTION

cowiconman displays a clickable list of windows known to cow(1).

With no filters, all windows are shown. Filters combine, so an output, desk, and page filter together show only windows matching all three.

The window size follows the visible button grid, growing or shrinking as windows enter or leave the list. It is capped to the selected output's usable area.

OPTIONS

--output VALUE
    Limit the list to an output. VALUE may be an output name, @N for cow's output number, current for cow's current output, or self for the output containing the cowiconman window.

--desk VALUE
    Limit the list to a desk. VALUE may be a desk number or current.

--page VALUE
    Limit the list to a page. VALUE may be X,Y or current.

--sort MODE
    Sort rows by title, app, id, or leave them in cow's order with none. The default is title.

--group-by MODE
    Group matching windows into one row. MODE may be none, app, title, output, or desk. The default is none.

--match FIELD=TEXT
    Only show windows whose FIELD contains TEXT. FIELD may be title, app, or id. Matching is case-insensitive and the option may be repeated. Prefix TEXT with ! to exclude matching windows.

--format FMT
    Row label format. Supported escapes are %t title, %a app_id, %i short window id, %o output, %d desk, and %%.

--rows N
    Arrange buttons into at most N rows before starting a new column.

--cols N
    Arrange buttons into N columns. The number of rows is computed from the visible window count.

--anchor VALUE
    Move the cowiconman window to the selected output's top or bottom usable edge. The default is none.

--button-width N
    Preferred button width in pixels. The default is 300.

--min-button-width N
    Minimum button width used when the preferred grid would exceed the output's usable width. The default is 80.

--iconified-marker
    Reserve space before each label and draw a small square there for iconified windows.

--show-self
    Include cowiconman windows in the list. They are hidden by default.

-h, --help
    Print usage and exit.

USE

Left-click a row to focus the window. If the window is iconified, it is restored and focused.

Left-click a grouped row to open a selector for the windows in that group. Selector rows include the short window id, output, and desk. Selecting a window restores/focuses it.

Middle-click a row to toggle the window's iconified state.

Use the pointer wheel to scroll when a fixed row layout has more entries than fit on screen.

An anchored --rows 1 layout behaves like a bar: it spans the selected output's usable width and divides that space evenly between entries.

EXAMPLES

Show every window:

    cowiconman &

Show only windows on the current desk and page:

    cowiconman --desk current --page current &

Run a manager for a specific output:

    cowiconman --output DP-1 &

Use cow's output number and preserve cow's window order:

    cowiconman --output @2 --sort none &

Use a two-column layout:

    cowiconman --cols 2 &

Group windows by application:

    cowiconman --group-by app &

Show only xterm windows:

    cowiconman --match app=xterm &

Hide xterm windows:

    cowiconman --match app=!xterm &

Use a one-row top task list for the current output:

    cowiconman --output current --rows 1 --anchor top &

Show an iconified-window marker before labels:

    cowiconman --iconified-marker &

Remove the border, handles, and titlebar from cowiconman while preserving the active decor theme:

    decor -d cowiconman-chrome border.width 0
    decor -d cowiconman-chrome border.handles false
    decor -d cowiconman-chrome titlebar.enabled false
    rule -g -Ton-map -ncowiconman-chrome -s %cowiconman decor -a cowiconman-chrome

SEE ALSO

cow(1), moocow(1), cowpager(1)

AUTHORS

Thomas Adam <thomas@xteddy.org>