blstatus 0.4

A status monitor for DWM or other window managers that use WM_NAME

blstatus

A status monitor for DWM (or any window manager that uses WM_NAME to fill a status bar). Compared to slstatus, blstatus is capable of displaying more information, and it also updates network, audio volume, and battery information asynchronously, rather than using polling.

Installation

blstatus has the following dependencies:

• python3-dev
• libcairo2-dev
• libgirepository2.0-dev

And the following dependencies available on PyPI:

• apscheduler
• asyncio-glib
• pulsectl-asyncio
• pydbus
• xlib

The package can be installed using pipx, e.g.:

sudo apt install pipx python3-dev libcairo2-dev libgirepository1.0-dev
pipx install blstatus

Configuration

blstatus can be configured with a file located at ~/.config/blstatus/config.ini, e.g.

[general]
# Text to use between components
# Needs to be quoted if spaces (or a quote character) are used
spacer = ' | '

# Enable if using statuscmd (https://dwm.suckless.org/patches/statuscmd/)
enable_signal_text = false

[date_time]
# Format string for the date command
# Must be quoted and % must be doubled
format = '+"%%Y-%%m-%%d %%A %%-I:%%M %%P"'

[memory]
# Interval in seconds between updating memory status
interval = 2.0

# Enable using nvidia-smi to get GPU memory usage
enable_gpu = false

[volume]
# Dictionary to map a PulseAudio sink/source name to an abbreviation
# If the end of a PulseAudio device name matches a key the value will be used
# If a PulseAudio device name doesn't match anything in the dictionary, source_sink_unknown_abbreviation is used
# Must be a single line
source_sink_abbreviations = { 'analog-stereo': 'A', 'hdmi-stereo': 'H', 'a2dp_sink': 'B', 'handsfree_head_unit': 'B' }

# Abbreviation to use if a sink/source name isn't known
source_sink_unknown_abbreviation = 'U'

To determine the key part of source_sink_abbreviations, PulseAudio sink/source names can be printed with:

import pulsectl

pulse = pulsectl.Pulse()
print([sink.name for sink in pulse.sink_list()])
print([source.name for source in pulse.source_list()])

Starting with systemd

A systemd service file is included in this repository which can be enabled and started like so:

# Copy the service file
cp blstatus.service ~/.local/share/systemd/user/

# Enable the service
systemctl --user enable blstatus

# Start the service
systemctl --user start blstatus