freddiehaddad / swaybar

Swaybar JSON protocol generator

Swaybar

A highly parallelized swaybar app written in Go.

List of components currently implemented included:

• Date/Time
• CPU Temperature
• CPU Utilization
• GPU Temperature
• Network Throughput

Sample Output

D 977.58 Kbps U 36.79 Mbps | CPU 0.9% | CPU 26.0°C | GPU 58.0°C | Oct 23 16:14

How it Works

The modules (or components) are each responsible for populating the status bar with specific data. For example, the network component provides data throughput rates for a given interface. Similarly, the time component returns time and date values.

Each component runs in its own thread and reports updates on a specified interval. For example, the network component can be set to publish updates every second, millisecond, ten microseconds, etc.

Whenever an update is pushed, the status bar will get updated allowing each components report updates at different intervals.

                    +---------------+       +---------------+
                    |  Component 0  |  ...  |  Component N  |
                    +-------+-------+       +-------+-------+
                            |                       |
                            v                       v
                  +------------------------------------------+
                  |         Asynchronous Data Buffer         |
                  +---------------------+--------------------+
                                        |
                                        v
                                 +-------------+
                                 |   Renderer  |
                                 +------+------+
                                        |
                                        v
+------------------------------------------------------------------------------+
| D 97.58 Kbps U 6.79 Mbps | CPU 0.9% | CPU 26.0°C | GPU 58.0°C | Oct 23 16:14 |
+------------------------------------------------------------------------------+

Building

go build -v -o bin ./...

Testing

go test -v ./...

Installation

After building the code, copy the generated binary to a directory of your choice and update your sway config bar section to launch the code. In this example, the program is copied to $HOME/.config/sway/statusbar.

The program will look for a config.yml file in a config directory in the same location as the executable.

Configuration

Refer to the config/config.yml reference file for configuring the status bar.

bar {
    status_command $HOME/.config/sway/statusbar
}