mirror of
https://codeberg.org/dnkl/yambar.git
synced 2025-04-22 04:15:39 +02:00
94 lines
2.4 KiB
Markdown
94 lines
2.4 KiB
Markdown
yambar-modules-river(5)
|
|
|
|
# NAME
|
|
river - This module provides information about the river tags
|
|
|
|
# DESCRIPTION
|
|
|
|
This module uses river's (https://github.com/ifreund/river, a dynamic
|
|
tiling Wayland compositor) status protocol to provide information
|
|
about the river tags.
|
|
|
|
It has an interface similar to the i3/sway module.
|
|
|
|
The configuration for the river module specifies one _title_ particle,
|
|
which will be instantiated once for each seat, with tags representing
|
|
the seats' name and the title of the seats' currently focused view.
|
|
|
|
It also specifies a _content_ template particle, which is instantiated
|
|
once for all 32 river tags. This means you probably want to use a
|
|
*map* particle to hide unused river tags.
|
|
|
|
# TAGS
|
|
|
|
[[ *Name*
|
|
:[ *Type*
|
|
:[ *Description*
|
|
| id
|
|
: int
|
|
: River tag number
|
|
| urgent
|
|
: bool
|
|
: True if the river tag has at least one urgent view.
|
|
| visible
|
|
: bool
|
|
: True if the river tag is focused by at least one output (i.e. visible on at least one monitor).
|
|
| focused
|
|
: bool
|
|
: True if the river tag is _visible_ and has keyboard focus.
|
|
| occupied
|
|
: bool
|
|
: True if the river tag has views (i.e. windows).
|
|
| state
|
|
: string
|
|
: Set to *urgent* if _urgent_ is true, *focused* if _focused_ is true, *unfocused* if _visible_ is true, but _focused_ is false, or *invisible* if the river tag is not visible on any monitors.
|
|
| seat
|
|
: string
|
|
: The name of the seat (*title* particle only, see CONFIGURATION)
|
|
| title
|
|
: string
|
|
: The seat's focused view's title (*title* particle only, see CONFIGURATION)
|
|
|
|
# CONFIGURATION
|
|
|
|
[[ *Name*
|
|
:[ *Type*
|
|
:[ *Req*
|
|
:[ *Description*
|
|
| title
|
|
: particle
|
|
: no
|
|
: Particle that will be instantiated with the _seat_ and _title_ tags.
|
|
| content
|
|
: particle
|
|
: yes
|
|
: Template particle that will be instantiated once for all of the 32 river tags.
|
|
| all-monitors
|
|
: bool
|
|
: no
|
|
: When set to false (the default), tags reflect river tags and seats
|
|
for the monitor yambar is on only. When set to true, tags reflect
|
|
the union of all monitors.
|
|
|
|
# EXAMPLES
|
|
|
|
```
|
|
bar:
|
|
left:
|
|
- river:
|
|
title: {string: { text: "{seat} - {title}" }}
|
|
content:
|
|
map:
|
|
tag: occupied
|
|
values:
|
|
false: {empty: {}}
|
|
true:
|
|
string:
|
|
margin: 5
|
|
text: "{id}: {state}"
|
|
```
|
|
|
|
# SEE ALSO
|
|
|
|
*yambar-modules*(5), *yambar-particles*(5), *yambar-tags*(5), *yambar-decorations*(5)
|
|
|