Skip to main content

py3status module to show the status of a UPS battery

Project description


Python module for py3status to monitor my UPS battery status




With Pip

pip install py3status-ups-battery-status

From Git

git clone
mkdir -p ~/.i3/py3status && cd ~/.i3/py3status
ln -s <PATH_TO_CLONED_REPO>/src/py3status-ups-battery-status/ ./

Building From AUR (Arch)

git clone
cd py3status-ups-battery-status
makechrootpkg -c -r $HOME/$CHROOT

Installing Arch package

sudo pacman -U --asdeps py3status-ups-battery-status-*-any.pkg.tar.zst


This module depends on the Network UPS Tools(nut) package. And having already configured your battery with it. It assumes that you've named your battery battery. If you've named it something else you can change it in the module itself.

Dependency installation on Arch:

pacman -S nut

Dependency installation on Debian:

apt install nut


Add the module to your list of configured py3status modules


order += "arch_updates"
order += "volume_status"
order += "ups_battery_status"

And then just restart your i3 session.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for py3status-ups-battery-status, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size py3status_ups_battery_status-0.1.2-py3-none-any.whl (4.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size py3status-ups-battery-status-0.1.2.tar.gz (3.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page