https://github.com/tonyjurg/venta_protocol_v2_device
Porting bobiboy/venta_protocol_v3_device to API v2
https://github.com/tonyjurg/venta_protocol_v2_device
home-automation humidifier venta
Last synced: about 2 months ago
JSON representation
Porting bobiboy/venta_protocol_v3_device to API v2
- Host: GitHub
- URL: https://github.com/tonyjurg/venta_protocol_v2_device
- Owner: tonyjurg
- License: mit
- Created: 2026-04-29T08:09:42.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-29T08:37:42.000Z (2 months ago)
- Last Synced: 2026-04-29T10:29:19.915Z (2 months ago)
- Topics: home-automation, humidifier, venta
- Language: Jupyter Notebook
- Homepage:
- Size: 11.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://www.repostatus.org/#active) [](https://opensource.org/licenses/MIT) [](https://www.python.org/)
# venta_protocol_v2_device
Small Python library to control Venta Air Humidifiers and Washers that use Protocol Version 2 (i.e., the ones using the `/datastructure` endpoint).
This package intentionally mirrors the public API style of
[`venta_protocol_v3_device`](https://github.com/bobiboy/venta_protocol_v3_device)
so migration/addaptation effort is kept at a minimum.
## Example usage (without `pip install`)
```python
import sys
sys.path.insert(0, "../") # relative to notebook dir
import venta_protocol_v2_device
```
## Example usage (once `pip install` is functioning)
```python
from venta_protocol_v2_device import Venta_Protocol_v2_Device
d = Venta_Protocol_v2_Device("192.168.178.87")
print(d.getStatus())
print(d.toJSON())
```
## Notebook examples
For longer, guided examples in Jupyter notebooks, see [`examples/notebooks`](examples/notebooks/README.md):
- Basic single-device control workflow.
## Supported control methods
- `setPower(bool)`
- `setSleepMode(bool)`
- `setAutomatic(bool)`
- `setFanSpeed(int)`
- `setTargetHum(int)`
- `setLEDStripActive(bool)`
- `setLEDStripMode(int)`
- `setLEDStripColor(str)`
- `setPowerMode(str)`
- `runUpdate(str)`
## Discovery
Based on analyzing sniffed UDP packets, it looks like discovery as found in protocol version `3.0` is not supported for protocol version `2.0` devices. Hence it is not included in this package. Instead use the device IP address directly:
```python
from venta_protocol_v2_device import Venta_Protocol_v2_Device
d = Venta_Protocol_v2_Device("192.168.178.87")
```
If you need stable addressing, configure a DHCP reservation for the Venta device in your router or access point.
## Corrections and/or Additions
Please feel free to raise issues or create pull request for corrections and/or additions.