Difference between revisions of "Bspwm"

From ArchWiki
Jump to: navigation, search
(duplicated content has been removed (thus leaving practically nothing), update merge request)
(General clean-up and simple installation guide.)
Line 2: Line 2:
 
{{Merge|Window Manager#List of window managers|A simple entry in that list could offer the same information.}}
 
{{Merge|Window Manager#List of window managers|A simple entry in that list could offer the same information.}}
  
= Description =
+
'''bspwm''' is a tiling window manager that represents windows as the leaves of a full binary tree. It has support for [http://standards.freedesktop.org/wm-spec/wm-spec-1.3.html EWMH] and multiple monitors, and is configured and controlled through messages.
  
'''bspwm''' is a tiling window manager that represents windows as the leaves of a full binary tree.
+
== Installation ==
  
= Key Features =
+
Install {{AUR|bspwm}} or {{AUR|bspwm-git}} from the [[AUR]]. You will also want to install {{AUR|sxhkd}} or {{AUR|sxhkd-git}}, a simple X hotkey daemon used to communicate with bspwm through {{ic|bspc}} as well as launch your applications of choice.
  
* Configured and controlled through messages.
+
To start bspwm on login, add the following to your {{ic|.xinitrc}}:
* Multiple monitors support.
+
* EWMH support.
+
* Hybrid tiling.
+
  
= Help =
+
{{bc|sxhkd &
 +
exec bspwm}}
  
* Documentation : <code>man bspwm</code>.
+
== Configuration ==
* Mailing List : bspwm ''at'' librelist.com.
+
 
* [https://bbs.archlinux.org/viewtopic.php?id=149444 Arch BBS]
+
Example configuration is found on [https://github.com/baskerville/bspwm/blob/master/examples/ GitHub].
* [https://github.com/baskerville/bspwm/blob/master/README.asciidoc GitHub project README]
+
 
 +
Copy [https://github.com/baskerville/bspwm/blob/master/examples/bspwmrc bspwmrc] to {{ic|~/.config/bspwm/bspwmrc}}, [https://github.com/baskerville/bspwm/blob/master/examples/sxhkdrc sxhkdrc] to {{ic|~/.config/sxhkd/sxhkdrc}} and make bspwmrc executable with {{ic|chmod +x ~/.config/bspwm/bspwmrc}}.
 +
 
 +
Documentation for bspwm is found by running {{ic|man bspwm}}.
 +
 
 +
There is also documentation for sxhkd found by running {{ic|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:
 +
{{bc|echo $BSPWM_SOCKET
 +
echo $XDG_CONFIG_HOME}}
 +
 
 +
If either of these do not respond with a value, then go to your .bashrc or .zshrc and add the following lines:
 +
{{bc|export XDG_CONFIG_HOME&#61;"~/.config"
 +
export BSPWM_SOCKET&#61;"/tmp/bspwm-socket"}}
 +
 
 +
== Help ==
 +
 
 +
* 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"

Revision as of 22:34, 10 September 2013

Merge-arrows-2.pngThis article or section is a candidate for merging with Window Manager#List of window managers.Merge-arrows-2.png

Notes: A simple entry in that list could offer the same information. (Discuss in Talk:Bspwm#)

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 bspwmAUR or bspwm-gitAUR from the AUR. You will also want to install sxhkdAUR or sxhkd-gitAUR, 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 .bashrc or .zshrc and add the following lines:

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

Help