gardena-bluetooth

What it is and what it does

This package provides Python control over Gardena Bluetooth-enabled watering computers by wrapping their Bluetooth services and characteristics into a usable interface. It includes device scanning, connection management, and data parsing for these devices. The package targets Home Assistant integration but can be used standalone; it requires Python 3.12 or later and depends on bleak and bleak-retry-connector for Bluetooth communication and tzlocal for timezone handling.

The main constraint is that Gardena devices allow only a single paired connection and require a factory reset to accept a new controller—this is a device limitation, not a package limitation. The package provides both a Python API and command-line tools for scanning devices and dumping their state.

Use it for:

• Integrate Gardena watering computers into Home Assistant for automated irrigation scheduling and monitoring.
• Build standalone Python scripts to scan for and control Gardena devices on a local network.
• Parse and monitor real-time data from Gardena watering computers without manufacturer cloud services.
• Automate garden watering schedules based on custom logic or external triggers via Python.
• Debug or inspect Gardena device state and available Bluetooth characteristics from the command line.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Controls Gardena Bluetooth-enabled watering computers by communicating with their Bluetooth services and characteristics, with built-in device scanning and data parsing.

Yes, if you own Gardena Bluetooth watering computers and want local control via Python or Home Assistant. The package is actively maintained, has low install friction, carries a permissive MIT license, and has no known vulnerabilities. The main gotcha is the single-connection limit on the devices themselves, not the package.

Install

gardena-bluetooth on PyPI

pip install gardena-bluetooth

uv add gardena-bluetooth

poetry add gardena-bluetooth

Installing gardena-bluetooth

Before you install

Low install friction with a pure-Python wheel and three runtime dependencies. Active maintenance with a recent release and ongoing repository activity.

License in practice

MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both personal and commercial projects.

Quickstart

pip install gardena-bluetooth

python -m gardena_bluetooth scan

python -m gardena_bluetooth connect [ADDRESS]

Requires Python 3.12 or later. Gardena devices allow only a single paired connection and require factory reset to accept a new controller.

Verify before relying

• Whether the package works with Gardena devices beyond watering computers or only that specific product line.
• Specific Gardena device models known to be compatible or tested with this version.
• Whether Home Assistant integration is automatic or requires separate configuration.

Package facts

Evidence: gardena_bluetooth-2.10.1-py3-none-any.whl

Tags

More Utilities packages