Zitrus

A set of opinionated system information fetchers written in Zig, for use in lemonbar.

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