BSPWM(1) Bspwm Manual BSPWM(1) (NAME) bspwm - (SYNOPSIS) bspwm [-h|-v|-c CONFIG_PATH] bspc --print-socket-path bspc DOMAIN [SELECTOR] COMMANDS bspc COMMAND [OPTIONS] [ARGUMENTS] (DESCRIPTION) bspwm . bspc . (OPTIONS) -h . -v . -c CONFIG_PATH . --print-socket-path bspwm . (COMMON DEFINITIONS) DIR := north | west | south | east CYCLE_DIR := next | prev (SELECTORS) . . : [REFERENCE#]DESCRIPTOR(.MODIFIER)* ( focused ). . : # : .. % . (Node) . NODE_SEL := [NODE_SEL#](DIR|CYCLE_DIR|PATH|any|first_ancestor|last|newest| older|newer|focused|pointed|biggest|smallest| )[.[!]focused][.[!]active][.[!]automatic][.[!]local] [.[!]leaf][.[!]window][.[!]STATE][.[!]FLAG][.[!]LAYER][.[!]SPLIT_TYPE] [.[!]same_class][.[!]descendant_of][.[!]ancestor_of] STATE := tiled|pseudo_tiled|floating|fullscreen FLAG := hidden|sticky|private|locked|marked|urgent LAYER := below|normal|above SPLIT_TYPE := horizontal|vertical PATH := @[DESKTOP_SEL:][[/]JUMP](/JUMP)* JUMP := first|1|second|2|brother|parent|DIR (Descriptors) DIR () . CYCLE_DIR () . PATH . any . first_ancestor . last . newest . older . newer . focused . pointed . biggest . smallest . . (Path Jumps) ( / ) ( DESKTOP_SEL ) . 1|first . 2|second . brother () . parent . DIR . (Modifiers) [!]focused . [!]active . [!]automatic . --presel-dir Node DOMAINS . [!]local . [!]leaf . [!]window . [!](tiled|pseudo_tiled|floating|fullscreen) . [!]same_class . [!]descendant_of . [!]ancestor_of . [!](hidden|sticky|private|locked|marked|urgent) . [!](below|normal|above) . [!](horizontal|vertical) . / Desktop . DESKTOP_SEL := [DESKTOP_SEL#](CYCLE_DIR|any|last|newest|older|newer| [MONITOR_SEL:](focused|^)| |)[.[!]focused][.[!]active] [.[!]occupied][.[!]urgent][.[!]local] [.[!]LAYOUT][.[!]user_LAYOUT] LAYOUT := tiled|monocle / Descriptors CYCLE_DIR . any . last . newest . older . newer . focused . ^ n- . MONITOR_SEL n- . . . / Modifiers [!]focused . [!]active . [!]occupied . [!]urgent . [!]local . [!](tiled|monocle) . [!](user_tiled|user_monocle) userLayout . / Monitor . MONITOR_SEL := [MONITOR_SEL#](DIR|CYCLE_DIR|any|last|newest|older|newer| focused|pointed|primary|^| |)[.[!]focused][.[!]occupied] / Descriptors DIR () . CYCLE_DIR () . any . last . newest . older . newer . focused . pointed . primary . ^ n- . . . / Modifiers [!]focused . [!]occupied . (WINDOW STATES) tiled . pseudo_tiled . floating . . fullscreen . (NODE FLAGS) hidden . sticky . private . locked node --close . marked ( ). . urgent . . (STACKING LAYERS) : BELOW NORMAL ABOVE. : tiled & pseudo-tiled < floating < fullscreen. (RECEPTACLES) (receptacle) . . . . . examples/receptacles . (DOMAINS) (Node) (General Syntax) node [NODE_SEL] COMMANDS NODE_SEL focused . (Commands) -f, --focus [NODE_SEL] . -a, --activate [NODE_SEL] . -d, --to-desktop DESKTOP_SEL [--follow] . --follow . -m, --to-monitor MONITOR_SEL [--follow] . --follow . -n, --to-node NODE_SEL [--follow] . --follow . -s, --swap NODE_SEL [--follow] () . --follow . -p, --presel-dir [~]DIR|cancel ( ). ~ DIR DIR cancel . " " (manual insertion mode) . -o, --presel-ratio RATIO . -v, --move dx dy dx dy . -z, --resize top|left|bottom|right|top_left|top_right|bottom_right|bottom_left dx dy dx dy . -y, --type CYCLE_DIR|horizontal|vertical . -r, --ratio RATIO|(+|-)(PIXELS|FRACTION) (0 < RATIO < 1). -R, --rotate 90|270|180 . -F, --flip horizontal|vertical . -E, --equalize . -B, --balance . -C, --circulate forward|backward . -t, --state ~|[~]STATE . ~ STATE . ~ STATE . -g, --flag hidden|sticky|private|locked|marked[=on|off] (toggle) . -l, --layer below|normal|above . -i, --insert-receptacle . -c, --close . -k, --kill ( ) . (Desktop) (General Syntax) desktop [DESKTOP_SEL] COMMANDS DESKTOP_SEL focused . (COMMANDS) -f, --focus [DESKTOP_SEL] . -a, --activate [DESKTOP_SEL] . -m, --to-monitor MONITOR_SEL [--follow] . --follow . -s, --swap DESKTOP_SEL [--follow] . --follow . -l, --layout CYCLE_DIR|monocle|tiled . -n, --rename . -b, --bubble CYCLE_DIR . -r, --remove . (Monitor) (General Syntax) monitor [MONITOR_SEL] COMMANDS MONITOR_SEL focused . (Commands) -f, --focus [MONITOR_SEL] . -s, --swap MONITOR_SEL . -a, --add-desktops ... . -o, --reorder-desktops ... . -d, --reset-desktops ... . -g, --rectangle WxH+X+Y . -n, --rename . -r, --remove . (Query) (General Syntax) query COMMANDS [OPTIONS] (Commands) . -N, --nodes [NODE_SEL] . -D, --desktops [DESKTOP_SEL] ( ) . -M, --monitors [MONITOR_SEL] ( ) . -T, --tree JSON . (Options) -m,--monitor [MONITOR_SEL|MONITOR_MODIFIERS], -d,--desktop [DESKTOP_SEL|DESKTOP_MODIFIERS], -n,--node [NODE_SEL|NODE_MODIFIERS] . --names . -M -D . (Wm) (General Syntax) wm COMMANDS (Commands) -d, --dump-state . -l, --load-state . . -a, --add-monitor WxH+X+Y . -O, --reorder-monitors ... . -o, --adopt-orphans . -h, --record-history on|off . -g, --get-status . -r, --restart . (Rule) (General Syntax) rule COMMANDS (Commands) -a, --add (|*)[:(|*)[:(|*)]] [-o|--one-shot] [monitor=MONITOR_SEL|desktop=DESKTOP_SEL|node=NODE_SEL] [state=STATE] [layer=LAYER] [honor_size_hints=(true|false|tiled|floating)] [split_dir=DIR] [split_ratio=RATIO] [(hidden|sticky|private|locked|marked|center|follow|manage|focus|border)=(on|off)] [rectangle=WxH+X+Y] . instance_name class_name name . -r, --remove ^|head|tail|(|*)[:(|*)[:(|*)]]... . -l, --list . (Config) (General Syntax) config [-m MONITOR_SEL|-d DESKTOP_SEL|-n NODE_SEL] [] . (Subscribe) (General Syntax) subscribe [OPTIONS] (all|report|monitor|desktop|node|...)* . EVENTS . (Options) -f, --fifo FIFO . -c, --count COUNT bspc COUNT . / Quit / General Syntax quit [] . / EXIT CODES bspc . / SETTINGS #RRGGBB true on false off . false . / Global Settings normal_border_color . active_border_color . focused_border_color . presel_feedback_color node --presel-{dir,ratio}. split_ratio . status_prefix . external_rules_command . : . : key1=value1 key2=value2 ... ( / rule ). automatic_scheme . : longest_side alternate spiral. initial_polarity . : first_child second_child. directional_focus_tightness DIR . : high low. removal_adjustment . presel_feedback . true . borderless_monocle monocle. gapless_monocle monocle. top_monocle_padding, right_monocle_padding, bottom_monocle_padding, left_monocle_padding monocle. single_monocle monocle . borderless_singleton . pointer_motion_interval ( ) . pointer_modifier . : shift control lock mod1 mod2 mod3 mod4 mod5. pointer_action1, pointer_action2, pointer_action3 pointer_modifier + button . : move resize_side resize_corner focus none. click_to_focus ( ). : button1 button2 button3 any none. button1 . swallow_first_click click_to_focus none . focus_follows_pointer . pointer_follows_focus . pointer_follows_monitor . mapping_events_count mapping_events_count . . ignore_ewmh_focus EWMH . ignore_ewmh_fullscreen EWMH . : none all : enter exit. ignore_ewmh_struts strut ( ). center_pseudo_tiled . true . remove_disabled_monitors . remove_unplugged_monitors . merge_overlapping_monitors ( ). (Monitor and Desktop Settings) top_padding, right_padding, bottom_padding, left_padding . (Desktop Settings) window_gap . (Node Settings) border_width . honor_size_hints true ICCCM . floating . tiled . false . false . (POINTER BINDINGS) click_to_focus ( ) none . pointer_modifier + button1 . pointer_modifier + button2 . pointer_modifier + button3 . pointer_modifier + button pointer_action . (EVENTS) report . monitor_add . monitor_rename . monitor_remove . monitor_swap . monitor_focus . monitor_geometry . desktop_add . desktop_rename . desktop_remove . desktop_swap . desktop_transfer . desktop_focus . desktop_activate . desktop_layout tiled|monocle . node_add . node_remove . node_swap . node_transfer . node_focus . node_activate . node_presel (dir DIR|ratio RATIO|cancel) . node_stack below|above . node_geometry . node_state tiled|pseudo_tiled|floating|fullscreen on|off . node_flag hidden|sticky|private|locked|marked|urgent on|off . node_layer below|normal|above . pointer_action move|resize_corner|resize_side begin|end . bspwm . / REPORT FORMAT . . M . m . O . o . F . f . U . u . L(T|M) . T(T|P|F|=|@) . G(S?P?L?M?) . / ENVIRONMENT VARIABLES BSPWM_SOCKET bspc bspwm. : /tmp/bspwm__-socket. / CONTRIBUTORS o Steven Allen o Thomas Adam o Ivan Kanakarakis / AUTHOR Bastien Dejean Bspwm 0.9.12 10/08/2025 BSPWM(1)