Synopsis
--------
-*bspwm* [*-h*|*-v*|*-c* 'CONFIG_PATH'|*-s* 'PANEL_FIFO'|*-p* 'PANEL_PREFIX']
+*bspwm* [*-h*|*-v*|*-c* 'CONFIG_PATH']
*bspc* 'COMMAND' ['ARGUMENTS']
*-c* 'CONFIG_PATH'::
Use the given configuration file.
-*-s* 'PANEL_FIFO'::
- Write the internal state to the given FIFO.
-
-*-p* 'PANEL_PREFIX'::
- Start every line written to the 'PANEL_FIFO' with the given prefix.
-
-
Configuration
-------------
----
WINDOW_SEL := <window_id>
- | (DIR|CYCLE_DIR|biggest|last|focused)[.floating|.tiled][.like|.unlike][.automatic|.manual][.urgent|.nonurgent]
+ | (DIR|CYCLE_DIR|biggest|last|focused|older|newer)[.floating|.tiled][.like|.unlike][.manual][.urgent][.local]
----
Primary Selectors
Selects the biggest window on the current desktop.
last::
- Selects the previously focused window on the current desktop.
+ Selects the previously focused window.
focused::
Selects the currently focused window.
+older::
+ Selects the window older than the focused window in the history.
+
+newer::
+ Selects the window newer than the focused window in the history.
+
Modifiers
^^^^^^^^^
unlike::
Only consider windows that have a different class than the current window.
-automatic::
- Only consider windows in automatic splitting mode.
-
manual::
Only consider windows in manual splitting mode (see *--presel*).
+local::
+ Only consider windows of the current desktop.
+
urgent::
Only consider urgent windows.
-nonurgent::
- Only consider nonurgent windows.
-
Desktop
~~~~~~~
----
DESKTOP_SEL := <desktop_name>
| ^<n>
- | (CYCLE_DIR|last|focused)[.occupied|.free][.urgent|.nonurgent]
+ | (CYCLE_DIR|last|focused|older|newer)[.occupied|.free][.urgent][.local]
----
Primary Selectors
focused::
Selects the currently focused desktop.
+older::
+ Selects the desktop older than the focused desktop in the history.
+
+newer::
+ Selects the desktop newer than the focused desktop in the history.
+
Modifiers
^^^^^^^^^
urgent::
Only consider urgent desktops.
-nonurgent::
- Only consider nonurgent desktops.
+local::
+ Only consider desktops of the current monitor.
Monitor
~~~~~~~
----
MONITOR_SEL := <monitor_name>
| ^<n>
- | (DIR|CYCLE_DIR|last|primary|focused)[.occupied|.free]
+ | (DIR|CYCLE_DIR|last|primary|focused|older|newer)[.occupied|.free]
----
Primary Selectors
focused::
Selects the currently focused monitor.
+older::
+ Selects the monitor older than the focused monitor in the history.
+
+newer::
+ Selects the monitor newer than the focused monitor in the history.
+
Modifiers
^^^^^^^^^
Only consider monitors where the focused desktop is free.
+Window States
+-------------
+
+floating::
+ Is above any tiled window and can be moved/resized freely. Although it doesn't occupy any tiling space, it is still part of the window tree.
+
+fullscreen::
+ Fills its monitor rectangle, is above all the other windows and has no borders.
+
+locked::
+ Ignores the *close* message.
+
+sticky::
+ Stays in the focused desktop of its monitor.
+
+private::
+ Tries to keep the same tiling position/size.
+
+
Commands
--------
*-r*, *--ratio* 'RATIO'::
Set the splitting ratio of the selected window (0 < 'RATIO' < 1).
-*-e*, *--edge* 'DIR' 'RATIO'|pull|push::
- Set the splitting ratio (or pull, or push) the edge located in the given direction in relation to the selected window.
+*-e*, *--edge* 'DIR' 'RATIO'|±'PIXELS'|pull|push::
+ Set and change the splitting ratio of (or pull, or push) the edge located in the given direction in relation to the selected window.
*-R*, *--rotate* 'DIR' '90|270|180'::
Rotate the tree holding the edge located in the given direction in relation to the selected window.
-*-t*, *--toggle* floating|fullscreen|locked[=on|off]::
+*-t*, *--toggle* floating|fullscreen|locked|sticky|private[=on|off]::
Set or toggle the given state for the selected window.
*-c*, *--close*::
*-C*, *--circulate* forward|backward::
Circulate the leaves of the tree of the selected desktop.
+*-t*, *--toggle* floating[=on|off]::
+ Set or toggle the given state for the selected desktop.
+
+
Monitor
~~~~~~~
*-r*, *--remove-desktops* <name>...::
Remove desktops with the given names.
-*-p*, *--pad* <top> <right> <bottom> <left>::
- Set the padding of the selected monitor.
+*-o*, *--reorder-desktops* <name>...::
+ Reorder the desktops of the selected monitor to match the given order.
+
+*-d*, *--reset-desktops* <name>...::
+ Rename, add or remove desktops depending on whether the number of given names is equal, superior or inferior to the number of existing desktops.
*-n*, *--rename* <new_name>::
Rename the selected monitor.
*-H*, *--history*::
Print the history as it relates to the query.
+*-S*, *--stack*::
+ Print the window stacking order.
+
[*-m*,*--monitor* ['MONITOR_SEL']] | [*-d*,*--desktop* ['DESKTOP_SEL']] | [*-w*, *--window* ['WINDOW_SEL']]::
Constrain matches to the selected monitor, desktop or window.
*-H*, *--history* <file_path>::
Load the focus history from the given file.
+*-S*, *--stack* <file_path>::
+ Load the window stacking order from the given file.
+
Control
~~~~~~~
^^^^^^^
*--adopt-orphans*::
- Manage all the unmanaged windows remaining from a previous session.
-
-*--put-status*::
- Write the current internal state to the panel FIFO.
+ Manage all the unmanaged windows remaining from a previous session.
*--toggle-visibility*::
- Toggle the visibility of all the managed windows.
+ Toggle the visibility of all the windows.
+
+*--record-history* on|off::
+ Enable or disable the recording of window focus history.
+
+*--subscribe*::
+ Continuously print status informations on standard output.
Pointer
~~~~~~~
Options
^^^^^^^
+*-g*, *--grab* focus|move|resize_side|resize_corner::
+ Initiate the given pointer action.
+
*-t*, *--track* <x> <y>::
Pass the pointer root coordinates for the current pointer action.
-*-g*, *--grab* focus|move|resize_side|resize_corner::
- Perform the given pointer action.
+*-u*, *--ungrab*::
+ Terminate the current pointer action.
Rule
~~~~
Options
^^^^^^^
-*-a*, *--add* <pattern> [-d 'DESKTOP_SEL' [--follow]] [--floating] [--focus] [--unmanage]::
- Create a new rule (<pattern> must match the class or instance name).
+*-a*, *--add* <class_name>|<instance_name>|* [*-o*|*--one-shot*] [desktop=DESKTOP_SEL|monitor=MONITOR_SEL] [(floating|fullscreen|locked|sticky|private|center|lower|follow|manage|focus)=(true|false)]::
+ Create a new rule.
-*-r*, *--rm* <rule_uid>...::
- Remove the rules with the given UIDs.
+*-r*, *--remove* ^<n>|head|tail|<class_name>|<instance_name>|*...::
+ Remove the given rules.
-*-l*, *--list* [<pattern>]::
+*-l*, *--list* [<class_name>|<instance_name>|*]::
List the rules.
Config
All the boolean settings are 'false' by default.
+Global Settings
+~~~~~~~~~~~~~~~
'focused_border_color'::
Color of the border of a focused window of a focused monitor.
'normal_locked_border_color'::
Color of the border of an unfocused locked window.
-'urgent_border_color'::
- Color of the border of an urgent window.
+'focused_sticky_border_color'::
+ Color of the border of a focused sticky window of a focused monitor.
-'border_width'::
- Window border width.
+'active_sticky_border_color'::
+ Color of the border of a focused sticky window of an unfocused monitor.
-'window_gap'::
- Value of the gap that separates windows.
+'normal_sticky_border_color'::
+ Color of the border of an unfocused sticky window.
+
+'focused_private_border_color'::
+ Color of the border of a focused private window of a focused monitor.
+
+'active_private_border_color'::
+ Color of the border of a focused private window of an unfocused monitor.
+
+'normal_private_border_color'::
+ Color of the border of an unfocused private window.
+
+'urgent_border_color'::
+ Color of the border of an urgent window.
'split_ratio'::
Default split ratio.
+'growth_factor'::
+ Intensity of the growth involved in pulling or pushing an edge.
+
+'status_prefix'::
+ Prefix prepended to each of the status lines.
+
+'external_rules_command'::
+ External command used to retrieve rule consequences. The command will receive the the ID of the window being processed as its first argument and the class and instance names as second and third arguments. The output of that command must have the following format: *key1=value1 key2=value2 ...* (the valid key/value pairs are given in the description of the 'rule' command).
+
'history_aware_focus'::
Give priority to the focus history when focusing nodes.
'apply_floating_atom'::
Set the value of the '_BSPWM_FLOATING_WINDOW' atom of each window according to its floating state.
+'ignore_ewmh_focus'::
+ Ignore EWMH requests to focus a window.
+
+'remove_disabled_monitor'::
+ Consider disabled monitors as disconnected.
+
+Desktop Settings
+~~~~~~~~~~~~~~~~
+
+'window_gap'::
+ Size of the gap that separates windows.
+
+'top_padding'::
+'right_padding'::
+'bottom_padding'::
+'left_padding'::
+ Padding space added at the sides of the desktop.
+
+'border_width'::
+ Window border width.
+
+
+Status Format
+-------------
+
+Status informations are composed of items separated by colons.
+
+Each item has the form '<type><value>' where '<type>' is the first character of the item.
+
+'M<monitor_name>'::
+ Focused monitor.
+
+'m<monitor_name>'::
+ Unfocused monitor.
+
+'O<desktop_name>'::
+ Occupied focused desktop.
+
+'o<desktop_name>'::
+ Occupied unfocused desktop.
+
+'F<desktop_name>'::
+ Free focused desktop.
+
+'f<desktop_name>'::
+ Free unfocused desktop.
+
+'U<desktop_name>'::
+ Urgent focused desktop.
+
+'u<desktop_name>'::
+ Urgent unfocused desktop.
+
+'L(tiled|monocle)'::
+ Layout of the focused desktop of the focused monitor.
Environment Variables
---------------------
'BSPWM_SOCKET'::
- The path of the socket used for the communication between *bspc* and *bspwm*. If it isn't defined, then the following path is used: '/tmp/bspwm-socket'.
+ The path of the socket used for the communication between *bspc* and *bspwm*. If it isn't defined, then the following path is used: '/tmp/bspwm<display_name>-socket'.
Panels
------
Author
------
-Bastien Dejean <baskerville at lavabit.com>
+Bastien Dejean <nihilhill at gmail.com>
Mailing List
------------
projects / bspwm.git / blobdiff