https://github.com/jezza34000/homeassistant_petkit

🐾 The most advanced Petkit integration for Home Assistant : full device support, live stream, media, bluetooth relay & more.
https://github.com/jezza34000/homeassistant_petkit

airpurifier crystal-duo eversweet-5-mini eversweet-max feeder fresh-element hacs homeassistant homeassistant-integration iot petkit petkit-litter puramax purax purobot smart-feeder smarthome water-fountain yumshare

Last synced: about 2 months ago
JSON representation

🐾 The most advanced Petkit integration for Home Assistant : full device support, live stream, media, bluetooth relay & more.

• Host: GitHub
• URL: https://github.com/jezza34000/homeassistant_petkit
• Owner: Jezza34000
• License: mit
• Created: 2024-12-09T21:34:21.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2026-04-13T21:04:07.000Z (about 2 months ago)
• Last Synced: 2026-04-13T21:35:11.190Z (about 2 months ago)
• Topics: airpurifier, crystal-duo, eversweet-5-mini, eversweet-max, feeder, fresh-element, hacs, homeassistant, homeassistant-integration, iot, petkit, petkit-litter, puramax, purax, purobot, smart-feeder, smarthome, water-fountain, yumshare
• Language: Python
• Homepage: https://community.home-assistant.io/t/petkit-integration/834431
• Size: 5.77 MB
• Stars: 209
• Watchers: 4
• Forks: 17
• Open Issues: 17
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS
  • Security: SECURITY.md

Awesome Lists containing this project

README

          


[![GitHub Release][releases-shield]][releases] [![HACS Default](https://img.shields.io/badge/HACS-Default-blue.svg?style=for-the-badge&color=41BDF5)](https://hacs.xyz/docs/faq/custom_repositories)

## 🚀 Features

- **Control** : Control your Petkit devices directly from Home Assistant.

- **Monitor** : Monitor your devices status, monitor your pet's activity, feeding, drinking, and litter usage.

- **Bluetooth relay** : Automatically check your fountain over bluetooth relay.

- **Media** : Access media from your Petkit devices directly in the `Media` section.

- **Live Stream:** Watch live video from devices with camera (⚠ Firefox does not support live stream)

## 📘 Integration Wiki

- **[Supported Devices](https://github.com/Jezza34000/homeassistant_petkit/wiki/Supported-Devices)** - Complete list of compatible devices

- **[Installation](https://github.com/Jezza34000/homeassistant_petkit/wiki/Installation)** - Complete installation guide

- **[Migration](https://github.com/Jezza34000/homeassistant_petkit/wiki/Migration)** - Migration from RobertD502 or hasscc integration

- **[Configuration](https://github.com/Jezza34000/homeassistant_petkit/wiki/Configuration)** - Basic and advanced configuration

- **[Live stream modes](https://github.com/Jezza34000/homeassistant_petkit/wiki/Live-Stream-Modes)** - Live stream options

- **[Media Management](https://github.com/Jezza34000/homeassistant_petkit/wiki/Media-Management)** - Photo and video management

- **[Recommended Cards](https://github.com/Jezza34000/homeassistant_petkit/wiki/Recommended-Cards)** - Custom cards to enhance your dashboard

- **[Translations](https://github.com/Jezza34000/homeassistant_petkit/wiki/Translations)** - Language support and contribution guide

  

  

- **[Troubleshooting](https://github.com/Jezza34000/homeassistant_petkit/wiki/Troubleshooting)** - Solutions to common problems

- **[Development](https://github.com/Jezza34000/homeassistant_petkit/wiki/Development)** - Guide for contributors

## 🛟 Need help?

[![Discord][discord-shield]][discord]

[![Community Forum][forum-shield]][forum]

## ❤️ Enjoying this integration?

### Leave a Github Star ⭐ it's free and helps others discover this integration.

[![Sponsor Jezza34000][github-sponsor-shield]][github-sponsor] [![Static Badge][buymeacoffee-shield]][buymeacoffee]

---

[releases-shield]: https://img.shields.io/github/release/Jezza34000/homeassistant_petkit.svg?style=for-the-badge&color=41BDF5

[releases]: https://github.com/Jezza34000/homeassistant_petkit/releases

[discord]: https://discord.gg/Va8DrmtweP

[discord-shield]: https://img.shields.io/discord/1318098700379361362.svg?style=for-the-badge&label=Discord&logo=discord&color=5865F2

[forum-shield]: https://img.shields.io/badge/community-forum-brightgreen.svg?style=for-the-badge&label=Home%20Assistant%20Community&logo=homeassistant&color=18bcf2

[forum]: https://community.home-assistant.io/t/petkit-integration/834431

[github-sponsor-shield]: https://img.shields.io/badge/sponsor-Jezza34000-blue.svg?style=for-the-badge&logo=githubsponsors&color=EA4AAA

[github-sponsor]: https://github.com/sponsors/Jezza34000

[buymeacoffee-shield]: https://img.shields.io/badge/Donate-buy_me_a_coffee-yellow.svg?style=for-the-badge&logo=buy-me-a-coffee

[buymeacoffee]: https://www.buymeacoffee.com/jezza

## 🏅 Code quality

[![GitHub Activity][commits-shield]][commits] ![Project Maintenance][maintenance-shield] [![License][license-shield]](LICENSE)

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=Jezza34000_homeassistant_petkit&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)

[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=Jezza34000_homeassistant_petkit&metric=bugs)](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)

[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=Jezza34000_homeassistant_petkit&metric=code_smells)](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)

[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=Jezza34000_homeassistant_petkit&metric=coverage)](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)

[![Duplicated Lines (%)](https://sonarcloud.io/api/project_badges/measure?project=Jezza34000_homeassistant_petkit&metric=duplicated_lines_density)](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)

[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=Jezza34000_homeassistant_petkit&metric=reliability_rating)](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)

[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=Jezza34000_homeassistant_petkit&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)

[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=Jezza34000_homeassistant_petkit&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)

[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=Jezza34000_homeassistant_petkit&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)

[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=Jezza34000_homeassistant_petkit&metric=ncloc)](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit) _**KISS : Keep It Simple, Stupid. Less is More**_

### Petkit API client

This repository is based on my client library for the Petkit API, which can be found here : [Jezza34000/py-petkit-api](https://github.com/Jezza34000/py-petkit-api)

### Credits (thanks to)

- @ludeeus for the [integration_blueprint](https://github.com/ludeeus/integration_blueprint) template.

- @RobertD502 for the great reverse engineering done in this repository which helped a lot [home-assistant-petkit](https://github.com/RobertD502/home-assistant-petkit)

- @mikey0000 for his expertise and deep dive into Agora's reverse engineering: this integration wouldn't have live video without him. [Mammotion-HA](https://github.com/mikey0000/Mammotion-HA)

---

[homeassistant_petkit]: https://github.com/Jezza34000/homeassistant_petkit

[commits-shield]: https://img.shields.io/github/commit-activity/y/Jezza34000/homeassistant_petkit.svg?style=flat

[commits]: https://github.com/Jezza34000/homeassistant_petkit/commits/main

[discord]: https://discord.gg/Va8DrmtweP

[discord-shield]: https://img.shields.io/discord/1318098700379361362.svg?style=for-the-badge&label=Discord&logo=discord&color=5865F2

[forum-shield]: https://img.shields.io/badge/community-forum-brightgreen.svg?style=for-the-badge&label=Home%20Assistant%20Community&logo=homeassistant&color=18bcf2

[forum]: https://community.home-assistant.io/t/petkit-integration/834431

[license-shield]: https://img.shields.io/github/license/Jezza34000/homeassistant_petkit.svg??style=flat

[maintenance-shield]: https://img.shields.io/badge/maintainer-Jezza34000-blue.svg?style=flat

[releases-shield]: https://img.shields.io/github/release/Jezza34000/homeassistant_petkit.svg?style=for-the-badge&color=41BDF5

[releases]: https://github.com/Jezza34000/homeassistant_petkit/releases

[petkit-device-cards]: https://github.com/homeassistant-extras/petkit-device-cards

[schedule-card]: https://github.com/cristianchelu/dispenser-schedule-card

[github-sponsor-shield]: https://img.shields.io/badge/sponsor-Jezza34000-blue.svg?style=for-the-badge&logo=githubsponsors&color=EA4AAA

[github-sponsor]: https://github.com/sponsors/Jezza34000

[buymeacoffee-shield]: https://img.shields.io/badge/Donate-buy_me_a_coffee-yellow.svg?style=for-the-badge&logo=buy-me-a-coffee

[buymeacoffee]: https://www.buymeacoffee.com/jezza

[supported-devices]: https://github.com/Jezza34000/homeassistant_petkit/wiki/Supported-Devices