summaryrefslogtreecommitdiff
path: root/README.md
blob: 44154c3cb73e07231aaf5aa9b22483d5d99ffbfc (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# i3bar-river

This is a port of `i3bar` for [river](https://github.com/riverwm/river).

## Warning

It works on my machineā„¢, but this program is in early stage of development.

## i3bar compatibility

Full compatibility is desired, but right now not everything is implemented.

I've tested [`i3status-rs`](https://github.com/greshake/i3status-rust) and [`bumblebee-status`](https://github.com/tobi-wan-kenobi/bumblebee-status) and everything seems usable.

A list of things that are missing (for now):
- `short_text`
- `border[_top|_right|_bottom|_left]`
- Click events lack some info (IDK if anyone actually relies on `x`, `y`, `width`, etc.)
- Multiple seat support (river doesn't support this either, so it's fine for now)
- The JSON parsing implementation is not "streaming": all blocks should be on the same line

## Configuration

The configuration file should be stored in `$XDG_CONFIG_HOME/i3bar-river/config.toml` or `~/.config/i3bar-river/config.toml`.

Example configuration (everything except for `command` is optional):

```toml
background = "#282828"
color = "#ffffff"
separator = "#9a8a62"
tag_fg = "#d79921"
tag_bg = "#282828"
tag_focused_fg = "#1d2021"
tag_focused_bg = "#689d68"
tag_urgent_fg = "#282828"
tag_urgent_bg = "#cc241d"
font = "JetBrainsMono Nerd Font 10"
height = 20
command = "~/i3status-rust/target/debug/i3status-rs"
```