bspwm \- Tiling window manager based on binary space partitioning
.SH SYNOPSIS
.B bspwm
-.RI [ -v | "-s STATUS_FIFO" ]
+.RI [ -h | -v | "-s PANEL_FIFO" | "-p PANEL_PREFIX" ]
.P
.BI bspc " MESSAGE"
.RI [ ARGUMENTS ]
Its configuration file is
.IR $XDG_CONFIG_HOME/bspwm/autostart .
.P
-The recommended way of defining keyboard shortcuts is to use
+Keyboard and pointer bindings are defined through
.BR sxhkd .
.P
Example configuration files can be found in the
.BI list_monitors " [--quiet]"
Perform a dump of each monitor.
.TP
+.BI list_history
+Return the node focus history of each desktop.
+.TP
.BI list_windows
Return the list of managed windows (i.e. their identifiers).
.TP
.BI shift " left|right|up|down"
Exchange the current window with the given neighbor.
.TP
-.BI swap
+.BI swap " [--swap-focus|--keep-focus]"
Swap the focused window with the last focused window.
.TP
.BI push " left|right|up|down"
.BI nearest " older|newer [--skip-floating|--skip-tiled|--skip-class-equal|--skip-class-differ]"
Focus the nearest window matching the given constraints.
.TP
+.BI biggest
+Return the ID of the biggest tiled window.
+.TP
.BI circulate " forward|backward"
Circulate the leaves in the given direction.
.TP
.BI rename " CURRENT_NAME NEW_NAME"
Rename the desktop named CURRENT_NAME to NEW_NAME.
.TP
+.BI remove_desktop " DESKTOP_NAME ..."
+Remove the given desktops.
+.TP
.BI cycle_monitor " next|prev"
Select the next or previous monitor.
.TP
.BI remove_rule " UID ..."
Remove the rules with the given UIDs.
.TP
+.BI put_status
+Output the current state to the panel fifo.
+.TP
.BI adopt_orphans
Manage all the unmanaged windows remaining from a previous session.
.TP
-.BI restore " FILE_PATH"
+.BI restore_layout " FILE_PATH"
Restore the layout of each desktop from the content of FILE_PATH.
.TP
+.BI restore_history " FILE_PATH"
+Restore the history of each desktop from the content of FILE_PATH.
+.TP
.BI quit " [EXIT_STATUS]"
Quit.
.SH SETTINGS
.I window_gap
Value of the gap that separates windows.
.TP
+.I split_ratio
+Default split ratio.
+.TP
.I top_padding
.TQ
.I right_padding
Whether to remove gaps for tiled windows in monocle mode.
.TP
.I focus_follows_pointer
-Wether to focus the window under the pointer.
+Whether to focus the window under the pointer.
.TP
.I adaptative_raise
Prevent floating windows from being raised when they might cover other floating windows.
Enable shadows for floating windows via the
.B _COMPTON_SHADOW
property.
+.TP
+.I auto_alernate
+Whether to interpret two consecutive identical
+.B use
+messages as an
+.B alternate
+message.
+.TP
+.I focus_by_distance
+Whether to use window or leaf distance for focus movement.
.SH ENVIRONMENT VARIABLES
.TP
.I BSPWM_SOCKET