https://github.com/javiorfo/ztatusbar
Configurable statusbar for Xorg server using xsetroot
https://github.com/javiorfo/ztatusbar
linux statusbar window-manager xorg zig
Last synced: 7 months ago
JSON representation
Configurable statusbar for Xorg server using xsetroot
- Host: GitHub
- URL: https://github.com/javiorfo/ztatusbar
- Owner: javiorfo
- License: mit
- Archived: true
- Created: 2024-11-19T22:37:45.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2025-01-29T21:24:19.000Z (9 months ago)
- Last Synced: 2025-04-13T12:06:07.445Z (7 months ago)
- Topics: linux, statusbar, window-manager, xorg, zig
- Language: Zig
- Homepage:
- Size: 52.7 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-zig - ztatusbar🗒️Configurable statusbar for Xorg server using xsetroot
README
# ztatusbar
*Configurable statusbar developed in Zig for Xorg server using xsetroot*
## Caveats
- Zig version **0.13.0**
- C lib dependencies: `xorg-xsetroot`, `curl`, `alsa`
- This library has been developed on and for Linux following open source philosophy.
## Installation
- Downloading, compiling and installing manually:
```bash
git clone https://github.com/javiorfo/ztatusbar
cd ztatusbar
sudo make clean install
```
**NOTE:** variable OPTIMIZE could be pass as parameter to activate different Zig build modes (default is ReleaseFast).
- From AUR Arch Linux:
```bash
yay -S ztatusbar
```
## Setup
- In your **~/.xinitrc** or **~/.xprofile** to start in every login
```bash
ztatusbar 2> ztatusbar.log &
```
## Overview
| Component | rstatusbar | NOTE |
| ------- | ------------- | ---- |
| CPU usage | :heavy_check_mark: | Percentage |
| RAM usage | :heavy_check_mark: | Percentage |
| TEMPERATURE | :heavy_check_mark: | Celcious |
| DISK USAGE | :heavy_check_mark: | Percentage |
| VOLUME LEVEL | :heavy_check_mark: | Level and Mute status |
| BLUETOOTH | :x: | |
| BATTERY LEVEL | :heavy_check_mark: | Percentage |
| CUSTOM SCRIPT | :heavy_check_mark: | Execute a custom script.sh |
| NETWORK STATUS | :heavy_check_mark: | Up or down |
| WEATHER | :heavy_check_mark: | Celcious, using [wttr](https://wttr.in/) |
| DATE | :heavy_check_mark: | Could be custimizable |
## Customizable
- By default the statusbar contains: **cpu usage, memory usage, temperature, disk usage, volume and datetime**
- For a custom configuration put this file [config.toml](https://github.com/javiorfo/ztatusbar/blob/master/config/config.toml) in your `~/.config/ztatusbar/config.toml` and edit it to change values or delete a component.
- Some configuration example in config.toml:
```toml
[memory]
time = 1000 # Time in miliseconds defines how often the process runs
name = "RAM" # Name of the component. Could be empty => name = ""
icon = "" # Icon of the component. Could be empty => icon = ""
[disk]
time = 2000
name = "DISK"
icon = " "
unit = "/"
[volume]
time = 100
name = "VOL"
icon = " "
icon_muted = " "
[temperature]
time = 1000
name = "TEMP"
icon = " "
zone = 1 # thermal zone which has the temperature in /sys/class/thermal_zone{variable here}/temp. If not set it uses thermal_zone0/temp
...
```
---
### Donate
- **Bitcoin** [(QR)](https://raw.githubusercontent.com/javiorfo/img/master/crypto/bitcoin.png) `1GqdJ63RDPE4eJKujHi166FAyigvHu5R7v`
- [Paypal](https://www.paypal.com/donate/?hosted_button_id=FA7SGLSCT2H8G)