124 lines
3.7 KiB
Plaintext
124 lines
3.7 KiB
Plaintext
/////
|
|
vim:set ts=4 sw=4 tw=82 noet:
|
|
/////
|
|
sway-bar (5)
|
|
============
|
|
|
|
Name
|
|
----
|
|
sway-bar - bar configuration file and commands
|
|
|
|
Description
|
|
-----------
|
|
|
|
Sway allows for configuration of swaybar within the sway configuation file.
|
|
Swaybar commands must be used inside a _bar { }_ block in the config.
|
|
|
|
|
|
Commands
|
|
--------
|
|
|
|
**status_command** <status command>::
|
|
Executes the bar _status command_ with _sh -c_. Each line of text printed to
|
|
stdout from this command will be displayed in the status area of the bar. You
|
|
may also use the i3bar JSON protocol:
|
|
+
|
|
https://i3wm.org/docs/i3bar-protocol.html
|
|
|
|
**pango_markup** <enabled|disabled>::
|
|
Enables or disables pango markup for status lines. This has no effect on
|
|
status lines using the i3bar JSON protocol.
|
|
|
|
**id** <bar_id>::
|
|
Sets the ID of the bar.
|
|
|
|
**position** <top|bottom>::
|
|
Sets position of the bar. Default is _bottom_.
|
|
|
|
**output** <output>::
|
|
Restrict the bar to a certain output, can be specified multiple times. If the
|
|
output command is omitted, the bar will be displayed on all outputs.
|
|
|
|
**swaybar_command** <command>::
|
|
Executes custom bar command, default is _swaybar_.
|
|
|
|
**font** <font>::
|
|
Specifies the font to be used in the bar.
|
|
|
|
**separator_symbol** <symbol>::
|
|
Specifies the separator symbol to separate blocks on the bar.
|
|
|
|
**wrap_scroll** <yes|no>::
|
|
Enables or disables wrapping when scrolling through workspaces with the
|
|
scroll wheel. Default is no.
|
|
|
|
**workspace_buttons** <yes|no>::
|
|
Enables or disables workspace buttons on the bar. Default is yes.
|
|
|
|
**strip_workspace_numbers** <yes|no>::
|
|
If set to _yes_, then workspace numbers will be omitted from the workspace
|
|
button and only the custom name will be shown.
|
|
|
|
**binding_mode_indicator** <yes|no>::
|
|
Enable or disable binding mode indicator. It's enabled by default.
|
|
|
|
**height** <height>::
|
|
Sets the height of the bar. Default height will match the font size.
|
|
|
|
Colors
|
|
------
|
|
|
|
Colors are defined within a _colors { }_ block inside a _bar { }_ block. Colors
|
|
must be defined in hex. i.e. _#rrggbb_ or _#rrggbbaa_ when including the alpha
|
|
channel.
|
|
|
|
**background** <color>::
|
|
Background color of the bar.
|
|
|
|
**statusline** <color>::
|
|
Text color to be used for the statusline.
|
|
|
|
**separator** <color>::
|
|
Text color to be used for the separator.
|
|
|
|
**focused_background** <color>::
|
|
Background color of the bar on the currently focused monitor output. If not
|
|
used, the color will be taken from _background_.
|
|
|
|
**focused_statusline** <color>::
|
|
Text color to be used for the statusline on the currently focused monitor
|
|
output. If not used, the color will be taken from _statusline_.
|
|
|
|
**focused_separator** <color>::
|
|
Text color to be used for the separator on the currently focused monitor
|
|
output. If not used, the color will be taken from _separator_.
|
|
|
|
**focused_workspace** <border> <background> <text>::
|
|
Border, background and text color for a workspace button when the workspace
|
|
has focus.
|
|
|
|
**active_workspace** <border> <background> <text>::
|
|
Border, background and text color for a workspace button when the workspace is
|
|
active (visible) on some output, but the focus is on another one. You can only
|
|
tell this apart from the focused workspace when you are using multiple
|
|
monitors.
|
|
|
|
**inactive_workspace** <border> <background> <text>::
|
|
Border, background and text color for a workspace button when the workspace
|
|
does not have focus and is not active (visible) on any output. This will be
|
|
the case for most workspaces.
|
|
|
|
**urgent_workspace** <border> <background> <text>::
|
|
Border, background and text color for a workspace button when the workspace
|
|
contains a window with the urgency hint set.
|
|
|
|
**binding_mode** <border> <background> <text>::
|
|
Border, background and text color for the binding mode indicator. If not used,
|
|
the colors will be taken from _urgent_workspace_.
|
|
|
|
|
|
See Also
|
|
--------
|
|
|
|
**sway**(5)
|