Python package for controlling a Litter-Robot Connect self-cleaning litter box.
Project description
pylitterbot
Python package for controlling a Litter-Robot Connect self-cleaning litter box
This is an unofficial API for controlling Litter-Robot Connect self-cleaning litter boxes. The code is based on https://github.com/natekspencer/LitterRobotManager, which in turn was based on the discussions from https://community.smartthings.com/t/litter-robot-connect/106882 and my own reverse engineering of the API via the android APK. Session code information is based off of https://github.com/stianaske/pybotvac
Disclaimer
This API is experimental. Use at your own risk. Feel free to contribute if things are not working.
Installation
Install using pip
pip install pylitterbot
Alternatively, clone the repository and run
python setup.py install
Usage
import asyncio
from pylitterbot import Account
# Set email and password for initial authentication.
username = "Your username"
password = "Your password"
async def main():
# Create an account.
account = Account()
# Connect to the API and load robots
await account.connect(username=username, password=password, load_robots=True)
# Print robots associated with account.
print("Robots:")
for robot in account.robots:
print(robot)
if __name__ == "__main__":
asyncio.run(main())
which will output something like:
Name: Litter-Robot Name, Serial: LR3C012345, id: a0123b4567cd8e
To start a clean cycle
await robot.start_cleaning()
If no exception occurred, your Litter-Robot should now perform a clean cycle.
Currently the following methods are available in the Robot class:
- refresh()
- start_cleaning()
- reset_settings()
- set_panel_lockout()
- set_night_light()
- set_power_status()
- set_sleep_mode()
- set_wait_time()
- set_name()
- reset_waste_drawer()
- get_activity_history()
- get_insight()
Support Me
I'm not employed by Litter-Robot, and provide this python package as-is.
If you don't already own a Litter-Robot, please consider using my referal code and get $25 off your own robot (as well as a tip to me in appreciation)!
If you already own a Litter-Robot and/or want to donate to me directly, consider buying me a coffee (or beer) instead by using the link below:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pylitterbot-2021.8.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d5845b57ef5dfea37e19da09a13df45fdc5673cad4147756bea3b66c3b14fb67 |
|
MD5 | 4e29b067358d9b80be792c64399f53ab |
|
BLAKE2b-256 | 6f5cdfd09c48d1c6afa53b60b997c56f8b562bdb5e9beec02553dd0d74c67b9a |