Skip to content

Latest commit

 

History

History
168 lines (122 loc) · 8.27 KB

README.md

File metadata and controls

168 lines (122 loc) · 8.27 KB

Petkit integration for Home Assistant


GitHub Release HACS Custom

GitHub Activity Project Maintenance License

Need help ? Join us :

Discord Community Forum

Enjoying this integration?

Sponsor Jezza34000 Static Badge

Picture feature is supported for feeders with camera (does not require an active subscription to Care+)
Video feature is not supported yet. it's planned for a future release. (REQUIRE an active subscription to Care+)

Supported devices

Legend :

📷 Still picture feature supported
🎥 Video clip feature supported (REQUIRE an active subscription to Care+)

🍗 Feeders :

  • Fresh Element
  • Fresh Element Mini Pro
  • Fresh Element Infinity
  • Fresh Element Solo
  • Fresh Element Gemini
  • YumShare Solo (with camera) 📷
  • YumShare Dual-hopper (with camera) 📷

🚽 Litters :

  • PuraX
  • PuraMax
  • PuraMax 2
  • Purobot Max Pro (with camera) (tester needed)
  • Purobot Ultra (with camera)

⛲ Fountains :

  • Eversweet Solo 2
  • Eversweet 3 Pro
  • Eversweet 3 Pro UVC
  • Eversweet 5 Mini
  • Eversweet Max

Important

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

Feeders special features

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 :

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

Installation

Via HACS (recommended), click here :

Open your Home Assistant instance and open the repository inside the Home Assistant Community Store.

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

To use both the official Petkit app AND Home Assistant simultaneously, you need two accounts:

  • Use your PRIMARY account with the official Petkit app to retain full control over device management.
  • Use your SECONDARY account for Home Assistant integration.

Add the secondary account to your primary account's family in the Petkit app.

How to create a family and add a member:

  1. Open the Petkit app and log in with your primary account.
  2. At the top of the screen, click on Family Management, then select Create a Family and follow the prompts.
  3. Once the family is created, click on the Add Family Member button.
  4. Add your secondary Petkit account.
  5. Finally, log into the Home Assistant integration using 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

Code quality

Quality Gate Status Bugs Code Smells Coverage Duplicated Lines (%) Reliability Rating Security Rating Maintainability Rating Vulnerabilities Lines of Code

Petkit API client

This repository is based on the client library for the Petkit API, which can be found here : Jezza34000/py-petkit-api

Credits

Thanks to :