This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
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

0.2

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

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 HPE HPE Development 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