Registry / iot / victron-mqtt

victron-mqtt

library2026.6.3pypypi✓ verified 80d ago

Python library for communicating with the MQTT interface of Victron Energy Venus OS devices (e.g., Cerbo GX, Color Control GX). Version 2026.6.3, supports Python >=3.13. Actively maintained, frequent releases.

iot

pip install victron-mqtt

github ↗homepage ↗

INSTALL

IMPORT

SIG · VICTRON-MQTT

victron-mqtt

iotpythonv2026.6.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Device

✓ from victron_mqtt import Device

✗ from victron_mqtt import VictronMqttClient

Connect to a Victron Venus OS MQTT broker and list available devices.

import os from victron_mqtt import VictronMqttClient client = VictronMqttClient( host=os.environ.get('VICTRON_HOST', 'localhost'), username=os.environ.get('VICTRON_USER', ''), password=os.environ.get('VICTRON_PASSWORD', '') ) client.start() # Subscribe to a single device client.subscribe('dbus/...') # Get devices devices = client.devices print(devices) # Wait for messages import time time.sleep(10) client.stop()

Debug

Known issues

breakingPython >=3.13 required. Older Python versions (3.12 and below) are not supported and will cause installation failures.

fix

Upgrade Python to 3.13 or later.

affects: >=2026.6.0

deprecatedThe method `client.subscribe_device()` has been deprecated in favor of `client.subscribe(topic_pattern)`. Old method may be removed in future releases.

fix

Use `client.subscribe('dbus/...')` with appropriate topic pattern.

affects: >=2026.5.0

gotchaThe library expects the MQTT broker to be running with WebSockets (port 9001) by default, not standard MQTT (1883). Ensure your Venus OS device has MQTT over WebSockets enabled.

fix

Set port parameter to 1883 if using standard MQTT, or enable WebSockets in Venus OS (Settings → MQTT).

affects: all

Upgrade

Version history

2026.6.3latest on PyPI · released Jun 6, 2026

Audit

Dependencies

paho-mqttrequiredMQTT broker communication

voluptuousrequiredSchema validation for device data

Agent activity

30 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/tomer-w/victron_mqtt ↗

homepagehttps://github.com/tomer-w/victron_mqtt ↗