oatbar 0.0.13

Powerful and customizable DE and WM status bar
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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

# Oatbar

[![Latest Version](https://img.shields.io/crates/v/oatbar.svg)](https://crates.io/crates/oatbar)
![Latest Build](https://img.shields.io/github/actions/workflow/status/igor-petruk/oatbar/on-push.yml)
![Crates.io License](https://img.shields.io/crates/l/oatbar)
![Libraries.io dependency status for latest release](https://img.shields.io/librariesio/release/cargo/oatbar)
![GitHub top language](https://img.shields.io/github/languages/top/igor-petruk/oatbar)
![Crates.io](https://img.shields.io/crates/d/oatbar?label=Cargo.io%20downloads)

It is a standalone desktop bar that can be used with various WMs and DEs. This bar aims to become one of the most full-featured bars available.

* Flexibility and pluggability of information sources from existing ecosystems
  * Arbitrary scripts
  * `i3blocks` format 
  * `i3status` format
  * PNG image embedding that could be rendered by a source script at runtime.
* External plugins are preferred, but the most basic modules are embedded: EWHM, layouts, clock, etc.
* Conversion of string sources to other types (numbers, bytes, percentages) that could be rendered by specialize widgets
* Native Pango markup support
* Source data cleaning via regexes so inflexible source module data can be cleaned inside of the `oatbar`.

![Panel Left](panel-sample-left.png)
![Panel Right](panel-sample-right.png)

[![Screenshot](https://raw.githubusercontent.com/igor-petruk/oatbar-media/main/screenshot-mini.png)](https://raw.githubusercontent.com/igor-petruk/oatbar-media/main/screenshot.png)

## Installation

### Pre-requisites

Please install `cargo` via the package manager or http://rustup.rs.

#### ArchLinux

```shell
# pacman -Sy pango cairo libxcb pkgconf
```

#### Ubuntu/Debian

```shell
# apt-get install -y build-essential pkg-config libcairo2-dev libpango1.0-dev libx11-xcb-dev
```

### Install

```shell
$ cargo install oatbar
```

### Configure

During the first launch the bar will create a default config at
`~/.config/oatbar.toml` that should work on most machines. The configuration
format is not documented and can change at any time, but it can be
reverse-engineered from `src/config.rs`. It will be documented when it
becomes more or less stable.

## Disclaimer

This is not an officially supported Google product.