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'.
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
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
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
~/.fluxbox/keys:
# 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.