Skip to content

kayloehmann/ha-gardena-smart-system

Repository files navigation

Gardena Smart System for Home Assistant

HACS Custom GitHub Release Home Assistant License Quality Scale mypy Test Coverage

A Home Assistant custom integration for Husqvarna smart garden devices — supporting both the Gardena Smart System API and the Automower Connect API through a single integration. Real-time WebSocket push with automatic polling fallback.

📖 Full documentation lives in the Wiki — available in English and German / Vollständige Dokumentation im Wiki — auf Englisch und Deutsch.


English

Quickstart

  1. Get Husqvarna API credentials. Go to the Husqvarna Developer Portal, create an Application (redirect URI https://localhost), and enable the Gardena Smart System API and/or Automower Connect API. Note the Application Key and Application Secret.
  2. Install via HACS. Open HACS → Integrations → search for Gardena Smart System → Download → restart Home Assistant. (If not listed: add https://github.com/kayloehmann/ha-gardena-smart-system as a custom repository, category Integration.)
  3. Add the integration. Go to Settings → Devices & Services → Add Integration → search Gardena Smart System → enter your Application Key and Secret → choose the API (Gardena or Automower).

To use both APIs, add the integration twice with the same credentials.

Documentation

Topic Link
Installation Wiki / Installation
Configuration Wiki / Configuration
Supported Devices Wiki / Supported Devices
Entities & Services Wiki / Entities and Services
API Rate Limits Wiki / API Rate Limits
MQTT Bridge Wiki / MQTT Bridge
Automation Examples Wiki / Automation Examples
Limitations Wiki / Limitations
Troubleshooting Wiki / Troubleshooting
Contributing Wiki / Contributing

Deutsch

Schnellstart

  1. Husqvarna-API-Zugangsdaten anlegen. Auf das Husqvarna Developer Portal gehen, eine Application erstellen (Redirect-URI https://localhost) und die Gardena Smart System API und/oder die Automower Connect API aktivieren. Application Key und Application Secret notieren.
  2. Über HACS installieren. HACS → Integrationen → nach Gardena Smart System suchen → Herunterladen → Home Assistant neu starten. (Nicht gelistet? https://github.com/kayloehmann/ha-gardena-smart-system als Custom Repository der Kategorie Integration hinzufügen.)
  3. Integration hinzufügen. Einstellungen → Geräte & Dienste → Integration hinzufügenGardena Smart System suchen → Application Key und Secret eingeben → API auswählen (Gardena oder Automower).

Um beide APIs zu nutzen, die Integration zweimal mit denselben Zugangsdaten hinzufügen.

Dokumentation

Thema Link
Installation Wiki / Installation
Konfiguration Wiki / Konfiguration
Unterstützte Geräte Wiki / Unterstützte Geräte
Entities & Services Wiki / Entities und Services
API-Rate-Limits Wiki / API-Rate-Limits
MQTT-Bridge Wiki / MQTT-Bridge
Automatisierungsbeispiele Wiki / Automatisierungsbeispiele
Einschränkungen Wiki / Einschränkungen
Fehlerbehebung Wiki / Fehlerbehebung
Mitwirken Wiki / Mitwirken

License

This project is licensed under the MIT License. See LICENSE for details.

About

Gardena Smart System integration for Home Assistant (HACS custom component)

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

 
 
 

Contributors

Languages