Metadata-Version: 1.1
Name: ws-grid-pager
Version: 0.2
Summary: A workspace grid pager for EMWH-compliant window-managers
Home-page: https://github.com/ckot/ws-grid-pager
Author: Scott Silliman
Author-email: scott.t.silliman@gmail.com
License: GNU General Public License v2 (GPLv2)
Download-URL: https://github.com/ckot/ws-grid-pager/archive/master.zip
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.
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Other Audience
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Desktop Environment :: Window Managers
Classifier: Topic :: Desktop Environment :: Window Managers :: Fluxbox
