BSPWM

Arrange desktop windows as leaves in a binary tree with bspwm, a tiling window manager that responds to X events.

github.com/baskerville/bspwm
BSPWM homepage screenshot

About BSPWM

BSPWM is a tiling window manager that arranges windows as the leaves of a full binary tree. Each monitor displays the tree of one desktop at a time. The program responds only to X events and to messages it receives on a dedicated socket. The bspc command sends those messages. New windows are placed either by the user (manual mode, using a preselection direction and optional split ratio) or automatically (using a longest-side scheme and polarity settings).

BSPWM does not process keyboard or pointer input itself. A separate program, such as sxhkd, translates those events into bspc calls. The default configuration is a shell script at $XDG_CONFIG_HOME/bspwm/bspwmrc that calls bspc, and example configurations are included in the repository. The source describes X event handling but does not state platform support, so the platform list in this directory entry should be checked against the project's documentation.

Key features

  • Represents windows as leaves of a full binary tree
  • Shows the tree of one desktop per monitor at a time
  • Manual insertion mode using node -p preselection direction
  • Automatic insertion using a longest-side scheme and polarity settings
  • Adjustable preselection split ratio with node -o
  • Keyboard and pointer bindings defined through sxhkd
Best for: Users who want a tiling window manager that they configure with shell scripts and separate hotkey tools.
Good for
  • Open source, with the repository listed under a license file
  • Includes example configuration files in the examples directory
  • Offers both manual and automatic window placement
Watch out for
  • Does not handle keyboard or pointer input; a third-party program such as sxhkd is required
  • Configuration relies on a shell script that calls bspc, so setup involves scripting

BSPWM at a glance

Type
Open-source project
Pricing
Not confirmed. Check the site
Platforms
Windows
Open source
Yes · Source code
Language
English
Last checked
Oct 6, 2026 · Online when checked
Listed
Oct 5, 2026

BSPWM alternatives

Tools and sites you could use instead, ranked by how closely they match.

All 24 alternatives

Popular in Desktop Customization

Well-known listings from the same topic.

All 172

BSPWM FAQ

Does BSPWM handle keyboard shortcuts on its own?
No. A third-party program, such as sxhkd, is needed to translate keyboard and pointer events into bspc commands.
Where is the default configuration file?
The default file is $XDG_CONFIG_HOME/bspwm/bspwmrc. It is a shell script that calls bspc, and it receives an argument indicating whether it runs after a restart.
Are there example configurations?
Yes. Example configuration files are included in the examples directory of the repository.
Is something wrong or out of date?

Tell us and an editor will check it.

Own this website?

Claim the listing and suggest updates yourself. An editor checks every claim first.

Claim this listing