"Mouseless navigation". Keyboard navigation and window tiling for Linux desktop.
Winterreise installs two programs, wint and winj.
The first program, winj, allows to use keyboard to switch between windows and workspaces.
It shows a menu with the colored list of windows, marked by letters a-z.
Colors are configurable. Pressing the key a-z "teleports" to that window.
Pressing the space bar brings up the previous window. Pressing 1-9 "teleports" to the corresponding workspace.
The second program, wint, allows to tile windows using predefined tiling schemes.
I use patterns from colourlovers.com for the window background:
nix profile install github:amkhlv/winterreise
This installs two programs: winj and wint.
Need to install Cargo, and some system libraries:
sudo apt-get install build-essential libxcb-ewmh-dev libxcb-icccm4-dev x11-utils libgtk-3-dev libgdk-pixbuf-2.0-dev libatk1.0-dev libpango1.0-dev libcairo-dev libglib2.0-dev
then build and install:
git clone https://github.com/amkhlv/winterreise
cd winterreise
cargo install --path .
This installs two programs:
-
wintfor tiling windows -
winjfor jumping between windows
They are installed into ~/.cargo/bin/ (which was added to PATH when cargo was installed).
There is a tiling description file ~/.config/winterreise/tilings.xml.
Each "geometry" is of the form x,y,width,height where x,y are the coordinates of the top left corner of the window.
Example of ~/.config/winterreise/tilings.xml:
<displays>
<display resolution="1600x900">
<window nick="tex" geometry="0,0,930,883"/>
<window nick="pdf" geometry="850,0,750,890"/>
<window nick="l" geometry="0,0,800,900"/>
<window nick="r" geometry="800,0,800,900"/>
</display>
<display resolution="1920x1080">
<window nick="tex" geometry="0,0,1150,1060"/>
<window nick="pdf" geometry="1100,0,820,1075"/>
<window nick="l" geometry="0,0,959,1060"/>
<window nick="r" geometry="960,0,960,1060"/>
</display>
</display>
Execution of the command wint brings up a dialog window containing:
-
A char-hinted list of windows on the current desktop
-
A command line at the bottom
In the command line, type the description of the desired layout. For example, if window charhinted a should be laid out as tex,
and window c as pdf, type:
atex cpdf
and press Enter. (Notice that the charhint is followed immediately by the name of the tiling model defined in tilings.xml.)
Execute:
winj -h
for help...
The colors of the buttons are determined by the CSS file ~/.config/winterreise/style.css.
The style classes listed in that file follow the pattern: wbtn_CLASSNAME.
If CLASSNAME contains a dot, replace it with underscore:
org.inkscape.Inkscape -> wbtn_org_inkscape_Inkscape
Run the command:
xprop WM_CLASS
The mouse cursor will become a cross. Click on the window in question. The output will be something like:
WM_CLASS(STRING) = "xterm", "UXTerm"
Notice that there are two values: "xterm" and "UXTerm"
The first one, "xterm", is called res_name , while the second ("UXTerm") is called res_class.
(Together they form a struct XClassHint of the xlib library.)
Our winj looks at res_class. It ignores res_name.
The res_name of a window is typically hard-coded in the application, and
sometimes it is desirable to change it.
A program called xdotool allows to change the res_name of any window. It is done
in two steps. The first step is to execute:
xdotool search --pid $WINDOW_PID
where $WINDOW_PID is the process ID of the process which owns the window.
The result will be a window code (or a list of codes, if there are several windows).
Let us call it $WINDOW_CODE. Then second step is to execute:
xdotool set_window --class NEWNAME $WINDOW_CODE
where NEWNAME is the res_class we want.
These lines in ~/.xbindkeysrc :
#winj
"winj >>/tmp/winterreise.log 2>&1"
m:0x40 + c:45
Mod4 + k
#winj-current
"winj -c >>/tmp/winterreise.log 2>&1"
m:0x40 + c:44
Mod4 + j
#tile
"wint"
m:0x40 + c:28
Mod4 + t
confugure keyboard shortcuts: Super+k and Super+j for winj, and Super+t for wint.