# Petkit integration for Home Assistant

[![GitHub Release][releases-shield]][releases] [](https://hacs.xyz/docs/faq/custom_repositories)

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

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

## Enjoying this integration?

### Show your support by sponsoring! Every donation helps keep the project alive and thriving.

[](https://github.com/sponsors/Jezza34000)

## Supported devices

Picture feature is supported for feeders with camera.
Video feature is not supported yet. it's planned for a future release.

> [!NOTE]
> Picture feature does not require an active Care+ subscription. \
> Video feature will require an active Care+ subscription.

### Feeders :

- [x] Fresh Element
- [x] Fresh Element Mini Pro
- [x] Fresh Element Infinity
- [x] Fresh Element Solo
- [x] Fresh Element Gemini
- [x] YumShare Solo with Camera
- [x] YumShare Dual-hopper with Camera

Add Feeding Schedule card for feeders :

Add this card to your HA with HACS : https://github.com/cristianchelu/dispenser-schedule-card (thanks to @cristianchelu)

On config card paste this :

```yaml
type: custom:dispenser-schedule-card
entity: sensor.MY_FEEDER_NAME_raw_distribution_data
editable: never
alternate_unit:
unit_of_measurement: g
conversion_factor: 10
approximate: true
```

### Litters :

- [x] PuraX
- [x] PuraMax
- [x] PuraMax 2
- [ ] Purobot Max Pro with camera (tester needed)
- [x] Purobot Ultra with camera

### Fountains :

- [x] Eversweet Solo 2
- [x] Eversweet 3 Pro
- [x] Eversweet 3 Pro UVC
- [x] Eversweet 5 Mini
- [x] Eversweet Max

> [!IMPORTANT]
> Fountain only support reading data, no control is available yet. it's planned for a future release.

## Installation

Via HACS (recommended), click here :

[](https://my.home-assistant.io/redirect/hacs_repository/?owner=Jezza34000&repository=homeassistant_petkit&category=integration)

Or follow these steps:

1. Open HACS (Home Assistant Community Store)
2. Click on the three dots in the top right corner
3. Click on `Custom repositories`
4. In the Repository field, enter https://github.com/Jezza34000/homeassistant_petkit/
5. In the Category field, select `Integration`
6. Click on `Add`
7. Search for `Petkit Smart Devices` in the list of integrations
8. Install the integration
9. Restart Home Assistant
10. Go to `settings` -> `integrations` -> `add integration` -> search for `Petkit Smart Devices`
11. Follow the instructions to configure the integration

## Configuration is done in the UI

> [!IMPORTANT]
> Accounts: \
> In order to use the official Petkit official application **AND** HomeAssistant simultaneously, you must have 2 accounts :
>
> - Use the **primary** account with your official Petkit application.
> - Use the **secondary** account for Home Assistant.
>
> Add the secondary account to the primary account's family in the Petkit application. \
>
> **How to create a family:**
>
> 1. Go to the Petkit application, when logged with your primary account.
> 2. At the top, click on `Family Management` and then on the `Create a family` button and follow the instructions.
> 3. Once finished, click the `Add family member` button.
> 4. Add your second Petkit account.
> 5. Now log in to the Home Assistant application with your secondary account.

## Available languages

This integration is available in the following languages:

- English
- Polish (thanks to @Chriserus)
- Spanish (thanks to @joasara)

## Contributions are welcome!

If you want to contribute to this please read the [Contribution guidelines](CONTRIBUTING.md)

## Code quality

[](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)
[](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)
[](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)
[](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)
[](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)
[](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)
[](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)
[](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)
[](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)
[](https://sonarcloud.io/summary/new_code?id=Jezza34000_homeassistant_petkit)

## Petkit API client

This repository is based on the 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 :

- @Leedeus 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)

---