Home

Bspwm

Getting Started

If you're using Arch Linux, install bspwm-git from AUR for the latest version or bspwm for the latest stable version, as well as sxhkd-git or sxhkd.

From Source

This guide will install both bspwm and sxhkd as they go hand-in-hand.

Dependencies

• Arch Linux: $ sudo pacman -S libxcb xcb-util xcb-util-wm xcb-util-keysyms
• Fedora: $ sudo dnf install libxcb xcb-util xcb-util-wm xcb-util-keysyms libxcb-devel xcb-util-wm-devel xcb-util-keysyms-devel xcb-util-devel
• Ubuntu/Debian: $ sudo apt-get install libxcb-xinerama0-dev libxcb-icccm4-dev libxcb-randr0-dev libxcb-util0-dev libxcb-ewmh-dev libxcb-keysyms1-dev libxcb-shape0-dev

Building and Installing

$ git clone https://github.com/baskerville/bspwm.git
$ git clone https://github.com/baskerville/sxhkd.git
$ cd bspwm && make && sudo make install
$ cd ../sxhkd && make && sudo make install

Uninstalling

$ cd bspwm && sudo make uninstall
$ cd ../sxhkd && sudo make uninstall

Running bspwm

You'll need to copy the example configurations to your ~/.config folder. Ensure ~/.config/bspwm/bspwmrc is executable.

$ mkdir -p ~/.config/{bspwm,sxhkd}
$ cp /usr/share/doc/bspwm/examples/bspwmrc ~/.config/bspwm/
$ cp /usr/share/doc/bspwm/examples/sxhkdrc ~/.config/sxhkd/
$ chmod u+x ~/.config/bspwm/bspwmrc

To start bspwm at login add exec bspwm to the bottom of your ~/.xinitrc or ~/.xprofile (depending on how your launch your X/Display manager). The example bspwmrc launches sxhkd for you.