/landroid_cloud

Landroid Cloud component for Home Assistant

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

landroid_cloud hacs_badge Maintenance downloads
Lokalize translation Buy me a coffee

INTEGRATION IS CURRENTLY NOT WORKING DUE TO API CHANGES

And because all the devices which I have access to are stored for the winter, I have no possibility to fix the integration until spring. IF you want to use this integration AND have a mower that is still online and willing to lend me access to your account, please email me your account credentials on landroid_cloud(at)trab.dk

Landroid Cloud

This component has been created to be used with Home Assistant.

Landroid Cloud presents a possibility to connect your Landroid Cloud compatible mowers to Home Assistant.
Currently these vendors are supported:

  • Worx Landroid
  • Kress
  • LandXcape

Installation:

HACS

  • Ensure that HACS is installed.
  • Search for and install the "Landroid Cloud" integration.
  • Restart Home Assistant.
  • Go to Integrations and add the Landroid Cloud integration

Manual installation

  • Download the latest release.
  • Unpack the release and copy the custom_components/landroid_cloud directory into the custom_components directory of your Home Assistant installation.
  • Restart Home Assistant.
  • Go to Integrations and add the Landroid Cloud integration

Example entry for configuration.yaml (legacy)

landroid_cloud:
  - email: this@example.com
    password: YourPassword

You can add multiple accounts like in this example:

landroid_cloud:
  - email: this@example.com
    password: YourPassword
  - email: another@example.com
    password: AnotherPassword

If you have LandXcape or Kress robots you can add type to the config instead of default 'worx':

landroid_cloud:
  - email: this@example.com
    password: YourPassword
    type: landxcape

Entities & Services

Once installed, the following entities are created in Home Assistant:

vacuum.[NAME_FROM_APP]

In addition, the following services are created:

Service name Description
landroid_cloud.configure Change configuration settings of device
landroid_cloud.partymode Toggle PartyMode if supported by device
landroid_cloud.setzone Set next zone to be mowed
landroid_cloud.lock Toggle device lock
landroid_cloud.restart Restart device baseboard OS
landroid_cloud.edgecut Start edgecut routine if supported by device

You can simply add these to your Lovelace setup by adding an entity card or using Barma-lej halandroid package

Translation

To handle submissions of translated strings I'm using Lokalise.
They provide an amazing platform that is easy to use and maintain.

To help out with the translation of this custom_component you need an account on Lokalise.
The easiest way to get one is to click here then select "Log in with GitHub".

When you have created your account, clich here to join the project on Lokalise.

Check Lokalise documentation here - it's really good.

Can't find the language you want to translate to? Open a new language request

Contributions to the translations will be updated on every release of this component.

Other useful information

Services and app stopped working

You might experience being banned from Worx Landroid Cloud service. Follow this simple guide to make it work again:

  • Go to My Landroids
  • Unlink your Landroid(s)
  • Open app on mobile device
  • Add Landroid(s)

To-do

  • Make this an official integration (far in the future as there is to many changes right now)