HLWM for Pandora

This is version 0.4.1 of the window manager for the OpenPandora handheld device, tested with a fresh install of SuperZaxxon Final 1.52. The current build is using the v0.4.1 git tag.

As there is no PND yet (and probably never will be ;) ), please follow these instructions to safely install it on your machine:


Download the tarball and extract it as root to the file system root on your Pandora:

wget https://www.localhorst.tv/hlwm-pnd/hlwm-0.4.1-pnd.tar.bz2
sudo tar xfp hlwm-0.4.1-pnd.tar.bz2 -C /

You will be prompted for your password to acquire the privileges for writing to protected directories.

After this you will need to fix a bug in /usr/pandora/scripts/op_switchgui.sh. Simply replace the line

if [ $gui ]; then
if [ "$gui" ]; then
(should be line 11).

Finally register the new GUI with the OP GUI switcher in /etc/pandora/conf/gui.conf by adding the line

herbstluftwm;a manual tiling window manager for X;herbstluftwm --autostart /etc/xdg/herbstluftwm/autostart;herbstclient quit
at a position of your choice. I put it after MiniMenu.

Note that the --autostart /etc/xdg/herbstluftwm/autostart can be omitted with the 0.4.1 build and thus /usr/pandora/scripts/op_switchgui.sh does not need patching.

You may now switch to herbstluftwm by selecting it from the GUI switcher.


For the moment, the supplied config at /etc/xdg/herbstluftwm/autostart only contains a very minimal setup. There are 4 tags and a few keybinds.

By default, the wm modifier is Control-Shift (i.e. both shoulder buttons). Tags are assigned to Mod+1-4, frames can be split by Mod+u (vertical) and Mod+o (horizontal), selected by Mod+dpad and resized with Mod+action buttons.

Most of the "usual" herbstluftwm keybinds, like Mod+Enter for spawing a terminal, also work.

To exit herbstluft, press Mod+Alt+q.

For further information and keybinds refer to /etc/xdg/herbstluftwm/autostart.


Finally, this is how it looks like:
3 terminals in herbstluftwm


Should you have any questions or suggestions, I will be hanging around in #herbstluftwm on freenode IRC as HolySmoke.

Older Versions