Step 1 : Install bspwm
either by installing from the debian repository or by building it from source .I will be using the debian repository for installation
Run the following commands. Use
sudo if you are not root
apt-get update && apt update apt install bspwm
You should get a prompt like this :
See carefully that the dependencies like
bspwm lemonbar libxcb-ewmh2 sxhkd xdo are automatically installed so you dont have to install these manually. Keep in mind though that if you are building from source , you would need to install these dependencies manually either from debian repository or by building them from source
Now the bspwm file was downloaded into your system and in almost all cases, the files are found in
In this folder , there are example config files that you can use. Or if you want , you can make your config files from scratch.
I will be using the examples configs to wrap it up faster
/usr/share/doc/bspwm/examples we will copy the
First make two directories (
sxhkd) in your
Next copy the
/usr/share/doc/bspwm/examples to your
.config directory using the following commands
mkdir ~/.config/bspwm && mkdir ~/.config/sxhkd cp /usr/share/doc/bspwm/examples/bspwmrc ~/.config/bspwm cp /usr/share/doc/bspwm/examples/sxhkdrc ~/.config/sxhkd
Normally , the
bspwmrc file that you copied just now should be an executable. You can check if its an executable or not from the this SO post or if you have a file manager like
ranger then , placing the cursor on
bspwmrc file should highlight it in
green colour (which means that its an executable and you can proceed to the next step)
If its not executable , then make it executable by
chmod +x bspwmrc
If you did the above steps correctly , you should see something like this in your
Now change the default
urxvt terminal to the terminal of your choice. I will set
super + Return to my default
You can also add your keybindings for opening web browser.
Note 1 : Focus on the
or in the heading. That means to do the following steps in only one file not all :-)
Note 2 : Check if you have any the files in the heading in your
home directory. In my case I didn't have them so I had to make them.
Making these files are simple. Just
touch .xsessionrc .
Edit the file and put the following lines in it :
#!/bin/bash exec bspwm
Note 3 : I got my
bspwm running by adding the above lines in
.xsessionrc . It may be possible that in your case you have to add the lines in
.xsession or any other file mentioned in the heading.
cd to your home directory where you have the file you created/modied in Step 5.
Then open the terminal and enter the following :
chmod +x .xsessionrc
Note : I created a
.xsessionrc file. If you have used any other file in Step 5 , then make it executable instead !
Logut and login again and you will be greeted with a black screen.
Use the keybinding you added in Step 4 to open up the terminal and install essentials like