Pet Card
PetKit feeders and water fountains: food, water, filter and a manual feed in two taps.
Cards for smart pet devices: food and water levels, filter and desiccant, today's meals and a manual feed from a popup. PetKit feeders and fountains are found on their own.
Highlights
- PetKit feeders (Fresh Element Infinity, Solo, Gemini, Mini Pro) and Eversweet fountains
- Food level per hopper, meals and food dispensed today
- Manual feed in a popup, in the feeder's own amounts
- Water level, filter left, mode and switches of the fountains
- Filter and desiccant reset with a confirmation
- Mini card with a detail button showing the full card
Cards
type: custom:pet-cardInstall
- 1Open the repository in the Marketplace with the Add to Marketplace button above, or add
github.com/juju35/ha-pet-cardas a custom repository (category Dashboard). - 2Download it from the Marketplace.
- 3Reload the browser and add the card from the dashboard editor.
Gallery 10
Documentation
From the README Features
Features
- Two cards: a full Pet Card and a compact Pet Mini Card
- Automatic discovery of the PetKit feeders and water fountains (all of them by default, or the ones you pick)
- Feeders: food level (or each hopper of a Gemini), status, errors, food dispensed today against the planned amount, meals today and the time of the last one, amount eaten and food left in the bowl when the feeder reports them, desiccant days left
- Manual feed in an in-card popup: the feeder's fixed amounts (Solo, Mini Pro), a gram stepper (Infinity, Fresh Element) or one portion stepper per hopper (Gemini)
- Water fountains: water level, filter left, mode (normal / smart), water purified and energy used today, power, light and do not disturb switches
- Filter and desiccant reset buttons, with a confirmation, once you have replaced them
- Status chip per device and for the whole card: Food low, Low water, Replace filter, Replace desiccant, Battery low, Offline, the feeder's own error message
- Click any value to open its Home Assistant history (more-info dialog)
- Detail button at the top right of the mini card: it switches to the full card and back; a click anywhere outside the card brings the compact view back
- Visual editor in the dashboard UI for both cards (no YAML needed)
- Light and dark mode; English, French, German, Spanish, Serbian (Cyrillic and Latin), Italian, Dutch, European Portuguese, Polish, Romanian, Danish, Swedish, Bulgarian, Russian, Ukrainian, Hungarian, Slovak, Czech, Slovenian, Latvian and Greek
- Single file, no external dependency
Supported integrations
Supported integrations
| Integration | What the cards show |
|---|---|
 PetKit (Marketplace) |
Feeders: food level or hoppers, status, error, dispensed / planned today, meals, eaten, food in bowl, desiccant with reset, battery, manual feed, call pet. Fountains: water level, filter with reset, mode, purified water, energy, power, light and do not disturb. Details in PetKit |
PetKit litter boxes and purifiers are left out for now: they are not shown, and do not get in the way.
Prerequisites
Prerequisites
Home Assistant 2024.8 or later, and the PetKit integration (available in the Marketplace), installed and configured with your PetKit account.
Configuration
Configuration
Visual editor#
Edit a dashboard, click Add card and search for Pet Card or Pet Mini Card. Every feeder and fountain is shown by default; tick the ones you want to keep only those, set an optional title, choose what to display and the language. The preview updates live, and options left at their default are kept out of the generated YAML.
Minimal#
type: custom:pet-card
type: custom:pet-mini-card
Full options#
type: custom:pet-card
devices:
- Kitchen feeder
- Living room fountain
title: Pets
show_title: true
show_subtitle: true
show_stats: true
show_controls: true
language: fr
type: custom:pet-mini-card
devices:
- Kitchen feeder
- Living room fountain
title: Pets
zoom: true
language: fr
Options reference#
| Option | Card | Default | Description |
|---|---|---|---|
devices |
both | All | Devices to show, in this order: their name (as in Home Assistant) or their device id (set by the visual editor). Feeders first, then fountains, when left out |
title |
both | Pets (translated) |
Card title |
show_title |
both | true |
Show the title in the header (e.g. false under a section heading of your own) |
show_subtitle |
both | true |
Show the subtitle (the devices' names) under the title |
show_stats |
full | true |
Today's figures: dispensed, meals, eaten, in the bowl, desiccant; purified water and energy for the fountains |
show_controls |
full | true |
Buttons: feed, call pet, power, mode, light, do not disturb, filter and desiccant resets |
zoom |
mini | true |
Detail button at the top right: switches to the full card and back (false removes it) |
language |
both | Auto | Force language: en, fr, de, es, sr, sr-Latn, it, nl, pt, pl, ro, da, sv, bg, ru, uk, hu, sk, cs, sl, lv or el (auto-detects from HA settings) |
PetKit
PetKit
The cards read the entities of the PetKit integration through the Home Assistant registries (platform: petkit, the entity's translation_key and its device), whatever their entity ids or language. A device is a feeder when it has a food level, a feeder status or a desiccant sensor, and a fountain when it has a water level, a filter or a purified water sensor.
| Card | PetKit entity (translation_key) |
|---|---|
| Food level | food_left (%) when the feeder reports it, else food_level (binary, on = low); food_level_hopper_one / _two on a Gemini |
| Status chip | feeder_status (offline, on_batteries), error (any message but no_error), battery_status (low) |
| Dispensed today | dispensed, against planned |
| Meals today | times_dispensed; last meal is when that count last changed |
| Eaten today / In the bowl | amount_eaten, food_in_bowl (feeders that weigh the bowl) |
| Desiccant | desiccant_days_remaining (orange from 5 days, red at 0), reset with reset_desiccant |
| Manual feed | manual_feed: a select of amounts (Solo, Mini Pro), a number in grams (Infinity, Fresh Element) or a text of portions per hopper a,b (Gemini) |
| Call pet | call_pet (Solo) |
| Water | water_level (binary, on = low) |
| Filter | filter (%, orange from 20 %, red from 5 %), reset with reset_filter |
| Mode | mode (normal, smart) |
| Purified today / Energy today | purified_water_today, energy_usage |
| Power, Light, Do not disturb | power, light, do_not_disturb switches |
Turning a fountain off and resetting a filter or a desiccant ask for a confirmation first; turning it on, the mode, the light and do not disturb act at once.
Last meal: PetKit has no "last meal" sensor, so the card shows when the count of meals of the day last changed. After a Home Assistant restart, that time is the restart until the next meal.
Manual feed#
The Feed button opens a popup at the top of the card with the amounts the feeder accepts, then Feed dispenses them:
Status colours
Status colours
| Item | Orange | Red |
|---|---|---|
| Food | low (or 10 % and less left) | — |
| Water | low | — |
| Filter | 20 % and less | 5 % and less |
| Desiccant | 5 days and less | 0 days |
| Feeder | on batteries, battery low | offline, error |
Support
Support
If you find this project useful, you can support its development:
Changelog
CHANGELOG.md 1.0.0Nov 13, 2026Latest
First release: Pet Card and Pet Mini Card, for the feeders and water fountains of the PetKit integration. Built from the integration's source and checked on mock data only: not tested on real devices yet.
Features
- Automatic discovery of the PetKit feeders and fountains through the Home Assistant registries (platform, translation key, device), whatever the entity ids or the language;
devicespicks some of them, by name or device id. - Feeders: food level (each hopper on a Gemini), status and errors, dispensed today against the planned amount, meals today and the last one, eaten and in the bowl when reported, desiccant days with a reset button.
- Manual feed in an in-card popup at the top of the card: the feeder's fixed amounts, a gram stepper or a portion stepper per hopper, depending on the model.
- Fountains: water level, filter with a reset button, mode, purified water and energy today, power, light and do not disturb.
- Status chip per device and for the whole card; the mini card lists one row per device and what needs doing.
- Mini card detail button switching to the full card and back.
- Visual editors for both cards; 22 languages, English in the bundle and the others loaded on demand.