swayfx/sway/sway-bar.5.scd

171 lines
5.9 KiB
Plaintext
Raw Normal View History

2018-05-12 11:13:43 +10:00
sway-bar(5)
# NAME
sway-bar - bar configuration file and commands
2018-05-12 11:13:43 +10:00
# DESCRIPTION
Sway allows configuring swaybar in the sway configuration file.
2018-05-12 11:13:43 +10:00
# COMMANDS
2018-05-12 11:13:43 +10:00
*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:
2016-06-10 23:32:14 +10:00
https://i3wm.org/docs/i3bar-protocol.html
If running this command via IPC, you can disable a running status command by
setting the command to a single dash: _swaybar bar bar-0 status\_command -_
2018-05-12 11:13:43 +10:00
*pango\_markup* enabled|disabled
2016-06-10 23:32:14 +10:00
Enables or disables pango markup for status lines. This has no effect on
status lines using the i3bar JSON protocol.
2016-04-25 02:57:35 +10:00
2018-05-12 11:13:43 +10:00
*id* <bar\_id>
Sets the ID of the bar.
2018-05-12 11:13:43 +10:00
*position* top|bottom
Sets position of the bar. Default is _bottom_.
2018-05-12 11:13:43 +10:00
*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.
2018-05-12 11:13:43 +10:00
*swaybar\_command* <command>
Executes custom bar command. Default is _swaybar_.
2018-05-12 11:13:43 +10:00
*font* <font>
Specifies the font to be used in the bar.
2018-05-12 11:13:43 +10:00
*separator\_symbol* <symbol>
Specifies the separator symbol to separate blocks on the bar.
2018-05-12 11:13:43 +10:00
*wrap\_scroll* yes|no
Enables or disables wrapping when scrolling through workspaces with the
2017-04-13 03:20:53 +10:00
scroll wheel. Default is _no_.
2018-05-12 11:13:43 +10:00
*workspace\_buttons* yes|no
2017-04-13 03:20:53 +10:00
Enables or disables workspace buttons on the bar. Default is _yes_.
2018-05-12 11:13:43 +10:00
*strip\_workspace\_numbers* yes|no
If set to _yes_, then workspace numbers will be omitted from the workspace
2017-04-13 03:20:53 +10:00
button and only the custom name will be shown. Default is _no_.
2018-05-12 11:13:43 +10:00
*binding\_mode\_indicator* yes|no
2017-04-13 03:20:53 +10:00
Enable or disable binding mode indicator. Default is _yes_.
2018-05-12 11:13:43 +10:00
*height* <height>
Sets the height of the bar. Default height will match the font size.
2018-10-09 02:40:13 +11:00
*bindsym* [--release] button<n> <command>
Executes _command_ when mouse button _n_ has been pressed (or if _released_
is given, when mouse button _n_ has been released). To disable the default
behavior for a button, use the command _nop_.
*mode* dock|hide|invisible
Specifies the visibility of the bar. In _dock_ mode, it is permanently
visible at one edge of the screen. In _hide_ mode, it is hidden unless the
modifier key is pressed, though this behaviour depends on the hidden state.
In _invisible_ mode, it is permanently hidden. Default is _dock_.
*hidden\_state* hide|show
Specifies the behaviour of the bar when it is in _hide_ mode. When the
hidden state is _hide_, then it is normally hidden, and only unhidden by
pressing the modifier key or in case of urgency hints. When the hidden
state is _show_, then it is permanently visible, drawn on top of the
currently visible workspace. Default is _hide_.
*modifier* <Modifier>|none
Specifies the modifier key that shows a hidden bar. Default is _Mod4_.
2018-05-12 11:13:43 +10:00
## TRAY
2018-05-12 11:13:43 +10:00
Swaybar provides a system tray where third-party applications may place icons.
The following commands configure the tray.
2018-05-12 11:13:43 +10:00
The _button_ argument in all cases is a platform-specific button code. On Linux
you can find a list of these at linux/input-event-codes.h.
*activate\_button* <button>
Sets the button to be used for the _activate_ (primary click) tray item
2018-05-12 11:13:43 +10:00
event. The default is BTN\_LEFT (0x110).
2018-05-12 11:13:43 +10:00
*context\_button* <button>
Sets the button to be used for the _context menu_ (right click) tray item
2018-05-12 11:13:43 +10:00
event. The default is BTN\_RIGHT (0x111).
2018-05-12 11:13:43 +10:00
*secondary\_button* <button>
Sets the button to be used for the _secondary_ (middle click) tray item
2018-05-12 11:13:43 +10:00
event. The default is BTN\_MIDDLE (0x112).
2018-05-12 11:13:43 +10:00
*tray\_output* none|all|<output>
Sets the output that the tray will appear on or none. Unlike i3bar, swaybar
2018-05-12 11:13:43 +10:00
is able to show icons on any number of bars and outputs without races.
The default is _all_.
2018-05-12 11:13:43 +10:00
*tray\_padding* <px> [px]
Sets the pixel padding of the system tray. This padding will surround the
tray on all sides and between each item. The default value for _px_ is 2.
2018-05-12 11:13:43 +10:00
*icon\_theme* <name>
Sets the icon theme that sway will look for item icons in. This option has
no default value, because sway will always default to the fallback theme,
hicolor.
2018-05-12 11:13:43 +10:00
## COLORS
Colors are defined within a _colors { }_ block inside a _bar { }_ block. Colors
2018-05-12 11:13:43 +10:00
must be defined in hex: _#RRGGBB_ or _#RRGGBBAA_.
2018-05-12 11:13:43 +10:00
*background* <color>
Background color of the bar.
2018-05-12 11:13:43 +10:00
*statusline* <color>
Text color to be used for the statusline.
2018-05-12 11:13:43 +10:00
*separator* <color>
Text color to be used for the separator.
2018-05-12 11:13:43 +10:00
*focused\_background* <color>
Background color of the bar on the currently focused monitor output. If not
used, the color will be taken from _background_.
2018-05-12 11:13:43 +10:00
*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_.
2018-05-12 11:13:43 +10:00
*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_.
2018-05-12 11:13:43 +10:00
*focused\_workspace* <border> <background> <text>
Border, background and text color for a workspace button when the workspace
has focus.
2018-05-12 11:13:43 +10:00
*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.
2018-05-12 11:13:43 +10:00
*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.
2018-05-12 11:13:43 +10:00
*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.
2018-05-12 11:13:43 +10:00
*binding\_mode* <border> <background> <text>
Border, background and text color for the binding mode indicator. If not used,
2018-05-12 11:13:43 +10:00
the colors will be taken from _urgent\_workspace_.
2018-05-12 11:13:43 +10:00
# SEE ALSO
2018-05-12 11:13:43 +10:00
*sway*(5)