/deebot-t8

Yet another client interface for connecting with Ecovacs Ozmo T8 line of robot vacuums

Primary LanguagePythonMIT LicenseMIT

⚠️ Warning: Abandonware Ahead ⚠️

This library is no longer under active development, as I have now migrated my Home Assistant integration to use DeebotUniverse/Deebot-4-Home-Assistant


Deebot T8

Yet another Deebot client library, intended to bring better support to Ozmo T8 range of robots.

Ecovacs Deebot OZMO T8 robot vacuum

This library is used by my Home Assistant custom component for the Deebot T8

Supported Robots

  • Ecovacs Deebot Ozmo T8 (Model: OT8G)

Other Deebot Ozmo T8 variant robots will likely also work, but have not been tested. Please open an issue if you have success with other models 😊

Models can be listed using the CLI: deebot-t8 list-devices

Features

  • Always up to date state using Ecovacs MQTT service
  • Fully featured command line interface
  • Extenable interface, with abstractions hiding ugly HTTP necessities

Install

To install the base library for use in other Python projects:

pip install deebot-t8

To install the base library, as well as the CLI dependencies:

pip install deebot-t8[cli]

The package exposes the cli as a deebot-t8 executable binary.

$> deebot-t8 --help
Usage: deebot-t8 [OPTIONS] COMMAND [ARGS]...

Options:
  --config-file PATH
  --help              Show this message and exit.

Commands:
  device
  list-devices
  login
  renew-access-tokens

Special Thanks

Contributing

I am more than happy to receive pull requests to add support for missing or broken features. Bug reports via issues also welcome, however is no guarantee of the bug being resolved

As this library is intended to be narrow focused on the Deebot T8 line, depending on the complexity burden, pull requests to support additional robots may be rejected.