Skip to content


Bspwm is a tiling window manager that represents windows as the leaves of a full binary tree.

In Athena OS, Bspwm shows different rices to fit the best workspace environment the user would like to work on.

Bspwm Environment

The environment consists of several elements that will shown in this chapter.

Each Bspwm rice has its own bar but they provides common features:

Bspwm Bar

Application Menu

By clicking on Athena or Arch logo icon, or by pressing SUPER + SPACE on your keyboard, the Application Menu will spawn. Here, you can find and open any installed application you wish to run.

Bspwm Application Menu

Window Switcher

Some rices have an icon showing overlapping windows that help you to switch among opened windows. In the image below, the window switcher is opened on the workspace 3 and shows windows opened in workspace 1 and 2.

Bspwm Window Switcher

You can also spawn it by pressing CTRL + ALT + W.


All the rices allow you to switch among workspaces. The difference of workspace menu inside each rice consists only of icons: glyphs or numbers.

Hack The Box Toolkit

Bspwm environment integrates with Hack The Box platform. TODO

System Metrics

On the bar, you can find some metrics about the system resource consumption like brightness percentage, disk space, CPU and RAM usage.

By clicking on the disk space icon, you can mount any existing drives (i.e., disk, partition or USB drives) to your system.

Bspwm Mount

As example, if you would like to use your USB drive, plug it in your computer, click on disk space icon, and on the popup window move to Mount and press Enter. You will get a list of drives, and among them, you will get the disk and the partition of your USB drive, for example in my case:

/dev/sdb (14.6 G) disk
/dev/sdb1 (14.6 G) part

You must select the part element in order to see the files inside your USB drive. Then, a name of folder where the USB drive should be mounted will be asked to you, and, finally, you can access to it by ls /mnt/d_mount/<folder-name>.

Once you finished your activity by USB drive, you can unmount it by clicking on disk space icon, move to Umount and press Enter.

Network, Audio and Power

WiFi icon allows you to connect to a network while Bluetooth one to a Bluetooth device. In this part of the bar, you can also tune your volume and update your packages.

Finally, a power icon button allows you to logout, lock, restart or shutdown your system.


The desktop is pretty simple in terms of elements. You have mainly a bar and a wallpaper.

If you wish to change your rice, press ALT + SPACE on your keyboard. A popup window containing the list of the rices appears:

Bspwm Rices

Select your favourite and press Enter.


Here are reported some useful keybindings set by default in Athena OS Bspwm.

Application and System Management

Super + EnterOpen the Terminal
Super + ALT + EnterOpen floating Terminal
Super + SpaceOpen application menu
Super + {H, U}Hide/Show menu bar
Super + ALT + WSet random wallpaper
ALT + SpaceOpen rice selector
CTRL + ALT + WActive window list
PrintOpen screenshot pane
Super + KHack The Box spawn machine
Super + Shift + KHack The Box machine details
Super + SHIFT + IHack The Box VPN
Super + ALT + OOpen scratchpad
CTRL + Super + ALT + {P, R, Q, L, K}Power off, Reboot, Log out, Lock screen, Kill an app
Shift + ALT + BOpen browser
Shift + ALT + GOpen VSCodium
Shift + ALT + EOpen File Manager
Shift + ALT + POpen Pavucontrol
Shift + ALT + ROpen Ranger
Shift + ALT + WOpen Athena Welcome
Shift + ALT + MOpen Virt-Manager
Shift + ALT + VOpen Neovim
Shift + ALT + KOpen music
Super + {self, Shift} + QClose or kill the focused window

Desktop and Window Selection

CTRL + ALT + {+, -, R}Change transparency on focused window
Super + RRotate desktop elements of 90 degree
Super + CRotate the leaves of the element tree
Super + =Make split ratio equal
Super + -Make split ratio balanced (use ‘dash’ key for minus character)
Super + MMake focused window maximized
Super + GSwap the focused window by the biggest opened window
Super + {T, Shift + T, S, F}Set the window state as tiled, pseudo tiled, floating or fullscreen
CTRL + ALT + {M, X, S, P, I}Set the window flag as marked, locked, sticky, private, hidden
Super + {4, 5}Focused window gaps scroll
Super + ALT + {4, 5}Global window gaps scroll
Super + {self, Shift} + {Left, Down, Up, Right}Focus the window in the given direction
ALT + {self, Shift} + TABFocus to the next or previous window in the current desktop
Super + ALT + {Left, Right}Move among workspaces
Super + {`, TAB}Focus the last window or desktop
Super + {O, I}Focus the older or newer window in the focus history
ALT + {self, Shift} + {1-9,0}Focus or move a window to the selected workspace

Desktop and Window Preselection

Super + CTRL + {Left, Down, Up, Right}Preselect the direction
Super + CTRL + {1-9}Preselect the ratio
Super + CTRL + SpaceCancel the preselection for the focused window
Super + CTRL + Shift + SpaceCancel the preselection for the focused workspace

Window Move/Resize

Super + ALT + {H, J, K, L}Expand a window by moving one of its side outward
Super + ALT + Shift + {H, J, K, L}Contract a window by moving one of its side inward
ALT + Shift + {Left, Down, Up, Right}Move a floating window

Second Monitor

Super + ALT + Shift + {Left, Right}Send window to the second monitor

Bspwm Management

Super + EscReload sxhkdrc
Super + ALT + RReload Bspwm