https://github.com/arguablykomodo/zitrus
A set of opinionated system information fetchers written in Zig, for use in lemonbar.
https://github.com/arguablykomodo/zitrus
lemonbar zig
Last synced: 5 months ago
JSON representation
A set of opinionated system information fetchers written in Zig, for use in lemonbar.
- Host: GitHub
- URL: https://github.com/arguablykomodo/zitrus
- Owner: arguablykomodo
- License: gpl-3.0
- Created: 2022-01-24T21:19:30.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2025-08-21T00:16:06.000Z (10 months ago)
- Last Synced: 2025-08-21T02:30:00.262Z (10 months ago)
- Topics: lemonbar, zig
- Language: Zig
- Homepage:
- Size: 71.3 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
# Zitrus
A set of opinionated system information fetchers written in Zig, for use in
[lemonbar](https://github.com/LemonBoy/bar).
## Building
Requires Zig 0.11.0.
`zig build` will build all the fetchers, zig build name
will build just the specified fetcher.
## Fetchers
### `cpu`
Displays CPU utilization as a percentage alongside per-core bars.
zitrus-cpu [interval] [color ...]
- `interval`: Time between updates, in milliseconds. Defaults to 1000. Shorter
intervals will lead to faster updates but less useful measurements.
- `color`: RRGGBB formatted color. Bars will use these colors blended
first-to-last based on percentage. Bars will be colorless if not present.
### `ram`
zitrus-ram [interval] [color ...]
Displays RAM usage as total percentage alongside a colored bar.
- `interval`: Time between updates, in milliseconds. Defaults to 1000.
- `color`: RRGGBB formatted color. Bar will use these colors blended
first-to-last based on percentage. Bar will be colorless if not present.
### `net`
Displays download/upload speed of all interfaces (excluding loopback).
zitrus-net down|up [interval]
- `interval`: Time between updates, in milliseconds. Defaults to 1000. Shorter
intervals will lead to faster updates but less useful measurements.
### `bspwm`
Displays list of current occupied bspwm desktops, with the focused desktop
highlighted. Requires `bspc` to be on `$PATH`.
zitrus-bspwm monitor_name [focus_color]
- `monitor_name`: Name of monitor whose desktops will be displayed. `bspc query
-M --names` can be useful to figure out the name.
- `focus_color`: Color used to highlight focused desktop.
### `mpd`
Displays current track artist, title, duration and elapsed time. Will display
filename if track has no title.
zitrus-mpd
### `pulseaudio`
Displays volume of default audio sink as a percentage. Requires linking with
`libc` and `libpulse`.
zitrus-pulseaudio