PAGINATOR(1)

NAME
paginator - X11 desktop pager

SYNOPSIS
paginator [-geometry geometry] [-name name] [-xrm resources] nrows ncols [primary secondary]

DESCRIPTION
paginator is a desktop pager for X11 that provides to the user a graphical interface to change the current desktop or the current window. It displays a grid of desktop miniatures representing actual virtual desktops managed by the window manager; on each desktop miniature there are window miniatures representing actual client windows on the screen. Each window miniature is identified by the icon of the client window it represents. The user can change the desktop of a client by drag-and-dropping its window miniature to another desktop miniature on the pager.

The options are as follows:

-geometry geometry
    Specify the initial size and location of the window. The format for the geometry argument is specified at XParseGeometry(3).

-name name
    Specify the name of paginator instance used to retrieve resources. If not specified, defaults to the value of the RESOURCES_NAME environment variable, or (if that variable is not set) to the basename of the command paginator was invoked as.

-xrm resources
    Specify additional resources to merge on top of X11's resouces database. If not specified, defaults to the value of the RESOURCES_DATA environment variable, or (if that variable is not set) to the empty string.

The first and second obligatory arguments, nrows and ncols are the number of rows and columns in the desktop grid.

The first and second optional arguments, primary and secondary, must each be set to either top, bottom, left, or right. These values specify a top-to-bottom, bottom-to-top, left-to-right or right-to-left primary and secondary placement respectively.

paginator only works in cooperation with EWMH-compliant window managers which set the _NET_CLIENT_LIST_STACKING and _NET_NUMBER_OF_DESKTOPS properties.

RESOURCES
paginator understands the following X resources. They must be prefixed with either the "Paginator" class, or the name given with the -name command-line option, followed by a period.

activeBackground
    The color of the background of the active window.

activeBorderColor
    The color of the border of the active window.

activeTopShadowColor, activeBottomShadowColor
    The light and dark colors of the Motif-like 3D shadow of the active window.

borderWidth
    The width in pixels of the borders of the window miniatures

currentDesktopBackground
    The color of the background for current desktop miniature.

desktopBackground
    The color of the background for desktop miniatures.

frameShadowThickness
    The width in pixels of the Motif-like 3D shadow frame around Paginator.

frameTopShadowColoror, frameBottomShadowColor
    The light and dark colors of the Motif-like 3D shadow of the frame around Paginator.

geometry
    The initial size and location of Paginator.

inactiveBackground
    The color of the background of the inactive window.

inactiveBorderColor
    The color of the border of the inactive window.

inactiveTopShadowColoror, inactiveBottomShadowColor
    The light and dark colors of the Motif-like 3D shadow of the inactive window.

separatorWidth
    The width in pixels of the separators between desktop miniatures.

shadowThickness
    The width in pixels of the Motif-like 3D shadow borders.

urgentBackground
    The color of the background of the urgent window.

urgentBorderColor
    The color of the border of the urgent window.

urgentTopShadowColoror, urgentBottomShadowColor
    The light and dark colors of the Motif-like 3D shadow of the urgent window.

ENVIRONMENT
The following environment variables affect the execution of paginator

DISPLAY
    The display to start paginator on.

EXAMPLES
To create a pager with 6 virtual desktops distributed as follows...

    +-------+-------+-------+
    |       |       |       |
    |   6   |   4   |   2   |
    |       |       |       |
    +-------+-------+-------+
    |       |       |       |
    |   5   |   3   |   1   |
    |       |       |       |
    +-------+-------+-------+

...run the following command:

    $ paginator 2 3 bottom right

The following command creates a pager with a 2x2 grid and default orientation:

    $ paginator 2 2

SEE ALSO
X(7)