- Home
- Packages
- Forums
- Wiki
- Bugs
- AUR
- Download

# Bspwm

From ArchWiki

bspwm is a tiling window manager that represents windows as the leaves of a full binary tree. It has support for EWMH and multiple monitors, and is configured and controlled through messages.

## Installation

Install bspwm or bspwm-git from the AUR. You will also want to install sxhkd or sxhkd-git, a simple X hotkey daemon used to communicate with bspwm through `bspc` as well as launch your applications of choice.

To start bspwm on login, add the following to your `.xinitrc`:

    sxhkd &
    exec bspwm

## Configuration

Example configuration is found on GitHub.

Copy bspwmrc to `~/.config/bspwm/bspwmrc`, sxhkdrc to `~/.config/sxhkd/sxhkdrc` and make bspwmrc executable with `chmod +x ~/.config/bspwm/bspwmrc`.

Documentation for bspwm is found by running `man bspwm`.

There is also documentation for sxhkd found by running `man sxhkd`.

These two files are where you will be setting wm settings and keybindings, respectively.

## Troubleshooting

The following environmental variables may need to be defined:

    echo $BSPWM_SOCKET
    echo $XDG_CONFIG_HOME

If either of these do not respond with a value, then go to your /etc/profile and add the following lines:

    export XDG_CONFIG_HOME="~/.config"
    export BSPWM_SOCKET="/tmp/bspwm-socket"

## See also

- Mailing List: bspwm at librelist.com.
- https://bbs.archlinux.org/viewtopic.php?id=149444 - Arch BBS thread
- https://github.com/baskerville/bspwm - GitHub project
- https://github.com/windelicato/dotfiles/wiki/bspwm-for-dummies - earsplit's "bspwm for dummies"

Retrieved from "https://wiki.archlinux.org/index.php?title=Bspwm&oldid=276404"
Category:

- Tiling WMs

## Navigation menu