Package: ws-grid-pager
ws-grid-pager=============A workspace pager supporting grid layout for EMWH-compliant X.org window managersMany minimalistic window managers don't natively support workspaces layedout as a grid.  This software treats the workspaces as if they actually are.Currently, this implementation requires that the environment variables:* WORKSPACE_ROWS* WORKSPACE_COLUMNSbe 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`` bitAlternative 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 fileUsage-----This package installs 4 command-line programs:* ws-grid-pager* gp-switch-workspace* gp-send-window* gp-take-windowAll 4 programs require a ``-d|--direction left|right|up|down`` argument as wellas an optional ``-w|--wrap`` argument if you'd prefer that left/right from thefirst/last column switches to the workspace/sends a window to the last/firstcolumn respectively. The same goes for up/down with the last/first rowThe 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 theprograms 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 Iwant wrapping myself, but have added support for folks who may.