commit
8af6a419ec
@ -0,0 +1,112 @@
|
||||
/////
|
||||
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_.
|
||||
|
||||
**id** <bar_id>::
|
||||
Sets the ID of the bar.
|
||||
|
||||
**position** <top|bottom|left|right>::
|
||||
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.
|
||||
|
||||
**workspace_buttons** <yes|no>::
|
||||
Enables or disables workspace buttons on the bar. Default is to enable
|
||||
buttons.
|
||||
|
||||
**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. E.g. _#fff000_ or _#fff000ff_ 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) **sway-input**(5)
|
Loading…
Reference in new issue