cowpager - Man Page
FvwmPager-style visual pager for the cow window manager
Synopsis
Description
cowpager is a small graphical pager that displays desks tracked by and the windows on them. Each desk is drawn as one unified canvas containing every windoW.
Without any options, cowpager will show all desks and windows across all outputs.
Options
- -r ROWS
Arrange desks in ROWS rows. If only -r is given, the number of columns is computed from the number of desks.
- -c COLS
Arrange desks in COLS columns. If only -c is given, the number of rows is computed from the number of desks. When neither -r nor -c is given, all desks are arranged in a single row.
- -m LIST
Restrict the pager to the listed outputss. LIST is one or more output names separated by commas (e.g. -m HDMI-A-1,DP-1). Both the tab strip and the windows drawn on the page grid are filtered to this set; tabs appear in the order given on the command line.
When -m names a single output, the tab strip is not shown.
Without -m, all outputs are shown in the way cow manages them. See cow(1) -- OUTPUT MANAGEMENT.
- -1
Display only the currently active desk.
- -h
Print usage and exit.
Display
Output Tabs
Each tab in a desk cell will show the following information:
- focused -- this output holds the focused window and that window lives on this desk. Shown as a bright green background.
- active -- this output's current desk is this desk (but the focused window is elsewhere). Shown as a light-grey background.
- present -- this output is on a different desk, but this desk contains at least one window owned by it. Shown as a thin blue accent stripe along the bottom of the tab.
- empty -- No windows at all, shown as a light-grey background.
The tab label is the output's name when it fits, falling back to its cow-assigned number when the name would overflow the slot.
Page Grid and Viewports
Window miniatures are placed on the grid. Windows are coloured by their id. The focused window is drawn in yellow.
For every output currently on the active desk, a translucent yellow rectangle marks that output's viewport position within the page grid. When two outputs share a desk but sit on different pages, both rectangles are drawn.
Use
Click a page cell: switches the host monitor (the one
cowpager itself is sitting on) to that desk and page.
Drag a coloured monitor name plate: grabs the small dark
pill at the top-left of a monitor's coloured viewport overlay
and drags it to another page cell. When you release, that monitor moves to the page selected.Click a window thumbnail: navigates that window's monitor to
the window's desk and page, then focuses the window. Other
monitors are not affected.- Click an output tab: switches that monitor to the clicked desk.
Examples
Show every output and every desk (the default):
cowpager &
Limit the pager to two specific outputs, arranged in two rows:
cowpager -r 2 -m HDMI-A-1,DP-1 &
Single-output pager pinned to DP-1, showing only the active desk:
cowpager -1 -m DP-1 &
See Also
Authors
Thomas Adam
Referenced By
cow(1), cowident(1), cowrearrange(1).