This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A workspace grid pager for EMWH-compliant window-managers

Project Description
ws-grid-pager
=============

A workspace pager supporting grid layout for EMWH-compliant X.org window managers

Many minimalistic window managers don't natively support workspaces layed
out as a grid. This software treats the workspaces as if they actually are.

Currently, this implementation requires that the environment variables:

* WORKSPACE_ROWS
* WORKSPACE_COLUMNS

be defined, although I plan to make this optional if the xprop property
``_NET_DESKTOP_LAYOUT`` is properly set.

Although this is designed for Fluxbox, it **should** work for any window manager which is at least minimally EMWH compliant.

Currently, I've only tested (manually) for my own 4x3 layout, on Xubuntu 14.04,
which is why I have this software listed as 'Beta'.


Installation
-------------

The only known dependencies are ``wmctrl`` and python's ``setuptools``. I *believe* that ``xprop`` will already be present on any X.org system, but if not, you'll need to install that as well.

``sudo pip install ws-grid-pager``

Depending on your system's configuration, you may be able to drop the ``sudo`` bit

Alternative installation methods
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

If you'd rather get the latest from git,

``sudo pip install -e https://github.com/ckot/ws-grid-pager.git``

\- or \-

Also, you can always download a .zip file from the github repo, and run

``sudo python setup.py install``

from the directory created once you unzip the file


Usage
-----

This package installs 4 command-line programs:

* ws-grid-pager
* gp-switch-workspace
* gp-send-window
* gp-take-window

All 4 programs require a ``-d|--direction left|right|up|down`` argument as well
as an optional ``-w|--wrap`` argument if you'd prefer that left/right from the
first/last column switches to the workspace/sends a window to the last/first
column respectively. The same goes for up/down with the last/first row

The ws-grid-pager program, being generic, also requires the argument:
``-a|--action switch-workspace|send-window|take-window``

A description of the cmd-line arguments will be listed if you run any of the
programs at the cmd-line either without any arguments or with ``-h|--help``

Suggested Usage with Fluxbox
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

``~/.fluxbox/keys:``

| # change to previous/next workspace
| #Control Mod1 Left :PrevWorkspace
| #Control Mod1 Right :NextWorkspace
| Control Mod1 Left :Exec gp-switch-workspace -d left
| Control Mod1 Right :Exec gp-switch-workspace -d right
| Control Mod1 Up :Exec gp-switch-workspace -d up
| Control Mod1 Down :Exec gp-switch-workspace -d down
| Shift Control Mod1 Left :Exec gp-switch-workspace -d left -w
| Shift Control Mod1 Right :Exec gp-switch-workspace -d right -w
| Shift Control Mod1 Up :Exec gp-switch-workspace -d up -w
| Shift Control Mod1 Down :Exec gp-switch-workspace -d down -w
|
| # send the current window to previous/next workspace
| #Mod4 Left :SendToPrevWorkspace
| #Mod4 Right :SendToNextWorkspace
| Mod4 Left :Exec gp-send-window -d left
| Mod4 Right :Exec gp-send-window -d right
| Mod4 Up :Exec gp-send-window -d up
| Mod4 Down :Exec gp-send-window -d down
| Shift Mod4 Left :Exec gp-send-window -d left -w
| Shift Mod4 Right :Exec gp-send-window -d right -w
| Shift Mod4 Up :Exec gp-send-window -d up -w
| Shift Mod4 Down :Exec gp-send-window -d down -w
|
| # send the current window and follow it to previous/next workspace
| #Control Mod4 Left :TakeToPrevWorkspace
| #Control Mod4 Right :TakeToNextWorkspace
| Control Mod4 Left :Exec gp-take-window -d left
| Control Mod4 Right :Exec gp-take-window -d right
| Control Mod4 Up :Exec gp-take-window -d up
| Control Mod4 Down :Exec gp-take-window -d down
| Shift Control Mod4 Left :Exec gp-take-window -d left -w
| Shift Control Mod4 Right :Exec gp-take-window -d right -w
| Shift Control Mod4 Up :Exec gp-take-window -d up -w
| Shift Control Mod4 Down :Exec gp-take-window -d down -w
|
Although you may or may not care to add the -w variants. I'm not sure if I
want wrapping myself, but have added support for folks who may.
Release History

Release History

This version
History Node

0.2

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
ws-grid-pager-0.2.tar.gz (5.5 kB) Copy SHA256 Checksum SHA256 Source Jan 22, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting