apcget — APC PowerChute UPS Status Tool

✦ Features

CLI Output

Print UPS load, battery, runtime, voltage and status directly to stdout — ideal for scripts and cron jobs.

JSON Output

Output all metrics as a single JSON object for easy integration with Home Assistant and other automation platforms.

MQTT Publishing

Publish metrics to any MQTT broker. Works with mosquitto_pub or paho-mqtt.

Zabbix Integration

Send all 6 metrics at once via zabbix_sender to a Zabbix trapper item.

Zero Dependencies

Core functionality uses Python standard library only. Optional features require MQTT or Zabbix tools.

Credential Management

Supports CLI args, environment variables, and a config file — no plain-text passwords in shell history.

▶ Quick Start

Download and run — no installation required:

# Download
curl -O https://raw.githubusercontent.com/yo1t/apcget/main/apcget.py

# Basic usage (returns UPS load %)
python3 apcget.py 192.168.1.100 username password

# All metrics as JSON
python3 apcget.py 192.168.1.100 username password --json

# Publish to MQTT
python3 apcget.py 192.168.1.100 username password \
  --mqtt-send 192.168.1.200 --mqtt-topic apcget/ups