diff options
Diffstat (limited to 'sway/sway-bar.5.scd')
| -rw-r--r-- | sway/sway-bar.5.scd | 64 |
1 files changed, 43 insertions, 21 deletions
diff --git a/sway/sway-bar.5.scd b/sway/sway-bar.5.scd index 873741c0..3f6b4298 100644 --- a/sway/sway-bar.5.scd +++ b/sway/sway-bar.5.scd @@ -50,6 +50,10 @@ Sway allows configuring swaybar in the sway configuration file. *workspace\_buttons* yes|no Enables or disables workspace buttons on the bar. Default is _yes_. +*strip\_workspace\_name* yes|no + If set to _yes_, then workspace names will be omitted from the workspace + button and only the custom number will be shown. Default is _no_. + *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. Default is _no_. @@ -57,13 +61,28 @@ Sway allows configuring swaybar in the sway configuration file. *binding\_mode\_indicator* yes|no Enable or disable binding mode indicator. Default is _yes_. +*gaps* <all> | <horizontal> <vertical> | <top> <right> <bottom> <left> + Sets the gaps from the edge of the screen for the bar. Gaps can either be + set all at once, per direction, or per side. Note that only sides that + touch an edge of the screen can have gaps. For the side that does not + touch an edge of the screen, per-side outer gaps for workspaces may be of + use. + *height* <height> - Sets the height of the bar. Default height will match the font size. + Sets the height of the bar. Default height (0) will match the font size. + +*bindcode* [--release] <event-code> <command> + Executes _command_ when the mouse button has been pressed (or if _released_ + is given, when the button has been released). The buttons can be given as + an event code, which can be obtaining from `libinput debug-events`. To + disable the default behavior for a button, use the command _nop_. -*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_. +*bindsym* [--release] button[1-9]|<event-name> <command> + Executes _command_ when the mouse button has been pressed (or if _released_ + is given, when the button has been released). The buttons can be given as a + x11 button number or an event name, which can be obtained from `libinput + debug-events`. 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 @@ -81,6 +100,16 @@ Sway allows configuring swaybar in the sway configuration file. *modifier* <Modifier>|none Specifies the modifier key that shows a hidden bar. Default is _Mod4_. +*status\_padding* <padding> + Sets the vertical padding that is used for the status line. The default is + _1_. If _padding_ is _0_, blocks will be able to take up the full height of + the bar. This value will be multiplied by the output scale. + +*status\_edge\_padding* <padding> + Sets the padding that is used when the status line is at the right edge of + the bar. This value will be multiplied by the output scale. The default is + _3_. + ## TRAY Swaybar provides a system tray where third-party applications may place icons. @@ -89,27 +118,20 @@ The following commands configure the tray. 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 - event. The default is BTN\_LEFT (0x110). - -*context\_button* <button> - Sets the button to be used for the _context menu_ (right click) tray item - event. The default is BTN\_RIGHT (0x111). - -*secondary\_button* <button> - Sets the button to be used for the _secondary_ (middle click) tray item - event. The default is BTN\_MIDDLE (0x112). - -*tray\_output* none|all|<output> - Sets the output that the tray will appear on or none. Unlike i3bar, swaybar - is able to show icons on any number of bars and outputs without races. - The default is _all_. +*tray\_bindsym* button<n> ContextMenu|Activate|SecondaryActivate|ScrollDown|ScrollLeft|ScrollRight|ScrollUp|nop + Binds mouse button _n_ (1 to 9) to the specified action. Use the command + _nop_ to disable the default action (Activate for button 1, ContextMenu for + button 2 and SecondaryActivate for button 3). *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. +*tray\_output* none|<output> + Restrict the tray to a certain output, can be specified multiple times. If + omitted, the tray will be displayed on all outputs. Unlike i3bar, swaybar + can show icons on any number of bars and outputs without races. + *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, |