Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/phillbush/paginator
X11 desktop pager dockapp
https://github.com/phillbush/paginator
dockapp window-maker windowmaker x11
Last synced: about 2 months ago
JSON representation
X11 desktop pager dockapp
- Host: GitHub
- URL: https://github.com/phillbush/paginator
- Owner: phillbush
- License: mit
- Created: 2022-03-08T12:55:20.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2023-08-22T14:54:11.000Z (over 1 year ago)
- Last Synced: 2023-08-22T18:38:00.321Z (over 1 year ago)
- Topics: dockapp, window-maker, windowmaker, x11
- Language: C
- Homepage:
- Size: 712 KB
- Stars: 15
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Paginator
(Paginator is at the top right on the image.)
Paginator is a desktop pager for EWMH-compliant X11 window managers that
support docked applications (dockapps), such as WindowMaker and Fluxbox.
Paginator shows a grid of desktop miniatures representing actual virtual
desktops; each one having window miniatures representing actual windows.
By manipulating those miniatures with the mouse, the user can change the
active window, set the desktop of a window, and switch between desktops.
Paginator is configured solely by X resources and command-line options.
## Options
Paginator understand the following command-line options.
* `-geometry geometry`: Specify the initial size for Paginator.
* `-name name`: Specify a resource/instance name for Paginator.
* `-xrm resources`: Specify X resources for Paginator.
## Customization
Paginator can be customized by setting the following X resources.
* `Paginator.activeBackground`:
Color of the miniature of the active window.
* `Paginator.activeBorderColor`:
Color of the border of the miniature of the active window.
* `Paginator.activeTopShadowColor`:
Color of the light shadow of the miniature of the active window.
* `Paginator.activeBottomShadowColor`:
Color of the heavy shadow of the miniature of the active window.
* `Paginator.borderWidth`:
Width in pixels of the border around the miniatures of windows.
* `Paginator.currentDesktopBackground`:
Color of the current desktop miniature.
* `Paginator.desktopBackground`:
Color of a desktop miniature.
* `Paginator.frameTopShadowColor`:
Color of the light shadow around Paginator.
* `Paginator.frameBottomShadowColor`:
Color of the heavy shadow around Paginator.
* `Paginator.frameShadowThickness`:
Width in pixels of the 3D shadow frame around Paginator.
* `Paginator.geometry`:
Initial geometry of paginator.
* `Paginator.inactiveBackground`:
Color of the miniature of a regular window.
* `Paginator.inactiveBorderColor`:
Color of the border of the miniature of a regular window.
* `Paginator.inactiveTopShadowColor`:
Color of the light shadow of the miniature of a regular window.
* `Paginator.inactiveBottomShadowColor`:
Color of the heavy shadow of the miniature of a regular window.
* `Paginator.urgentBackground`:
Color of the miniature of an urgent window.
* `Paginator.urgentBorderColor`:
Color of the border of the miniature of an urgent window.
* `Paginator.urgentTopShadowColor`:
Color of the light shadow of the miniature of an urgent window.
* `Paginator.urgentBottomShadowColor`:
Color of the heavy shadow of the miniature of an urgent window.
* `Paginator.separatorColor`:
Color of the separator between desktop miniatures.
* `Paginator.separatorWidth`:
Width in pixels of the separator between desktop miniatures.
* `Paginator.shadowThickness`:
Width in pixels of the 3D shadows.
## Installation
Run `make all` to build, and `make install` to install the binary and
the manual into `${PREFIX}` (`/usr/local`).
## Usage
Run `paginator` with a number of rows and columns:
```
$ paginator 2 3
```
This creates the following pager:
```
+-------+-------+-------+
| | | |
| 1 | 2 | 3 |
| | | |
+-------+-------+-------+
| | | |
| 4 | 5 | 6 |
| | | |
+-------+-------+-------+
```
## License
The code and manual are under the MIT/X license.
See `./LICENSE` for more information.
## Epilogue
**Read the manual.**