Cat Food Stats

Cat Food Stats

Starlark

GIMP

1.1.2026

Mini Dashboard for Tidbyt/Tronbyt showing cat food stats from HomeAssistant

Written by: Tobias

Project Cover Image.

🐈 PETKIT Cat Food Stats for Tidbyt / Tronbyt Server

⚠️ Recommended to use the script/automation via HomeAssistant with TidbytAssistant for automations and display notifications.

😺 Needs this Petkit HACS Integration to work: home-assistant-petkit Optional: Setup Helper Entity in HA for better usage

This Pixlet applet shows recent usage statistics from your automatic feeder (e.g. Fresh Element Gemini):

  • ℹ️ Choose Device Name
  • ⏲️ Choose Informations to Show
  • 🖌️ Choose Cat Pixel Art
  • 😺 Upload Custom Pixel Art for Your Cats

Preview

Tidbyt background
preview

preview

Available Cat Pixel Art

01234567891011
01234567891011

Setup


1. Setup home-assistant-petkit from HACS and follow the instructions

Install HACS on your HA Instance. Install Petkit HACS. Follow Setup Instructions there.

Optional: Setup Helper Entity in HA for better usage

Setup a new Helper Entity -> Input Daytime -> create: E.g. input_datetime.letztes_nassfutter

Home Assistant as Host

2. Setup TidbytAssistant from HACS

—> Easy way to send custom .star to yout Tidbyt Device locally. Install TidbytAssistan HACS. Follow Setup Instructions there.

3. Setup Script in HA to run cat_food_stats.star (YAML)

Example Script

sequence:
  - action: tidbytassistant.push
    metadata: {}
    data:
      contenttype: custom
      publishtype: foreground
      language: de
      customcontent: cat_food_stats/cat_food_stats.star     <-----(E.g. here: /tidbyt/cat_food_stats/cat_food_stats.star)
      devicename:
        - tidbyt
      arguments: >-
        server_address_input=-->PUT YOUR HA SERVER HERE<--/;server_api_key=-->PUT YOUR HA API KEY HERE<--;lang=de;entity_feeder_name=trockenfutter;top_info_line=time_wet;entity_last_wetfood_helper_name=letztes_nassfutter;number_of_hopper=2;food_type_order=Chicken,
        Salmon;cat_0_art=0;cat_1_art=1
alias: Cat_Food_Stats_Tidbyt
description: "Show Cat Food Stats on Tidbyt Screen."

Most Important here ist the arguments: field. Setup the values as needed.

⚠️ Important: when using the GUI of Tidbyt Push Script setup, put all key=value; pairs in one line!

arguments: >-
        server_address_input=-->PUT YOUR HA SERVER HERE<--/;server_api_key=-->PUT YOUR HA API KEY HERE<--;lang=de;entity_feeder_name=trockenfutter;top_info_line=time_wet;entity_last_wetfood_helper_name=letztes_nassfutter;number_of_hopper=2;food_type_order=Chicken,
        Salmon;cat_0_art=0;cat_1_art=1

Notes

  • Fields marked as optional can be left empty.
  • Numeric values are entered as text and parsed internally.
  • Custom pixel art overrides built-in art when selected.
  • JSON fields must use valid JSON syntax.

4. Setup Automation in HA to trigger Display (YAML)

This exmaple automation triggers, when the number of total feedings times changes. It wakes up and brightens the Tidbyt device up for 15 seconds, then runs the script and turns auto dim on and brightness down afterwards.

alias: Catfood Stats
description: "Trigger Cat Food Stats on Tidbyt Screen."
triggers:
  - trigger: state
    entity_id:
      - sensor.xxxxxxx_times_dispensed     <----- Put name of Feeder Device here (e.g. trockenfutter)
      - input_datetime.letztes_nassfutter     <----- Optional trigger, when Helper is set up
    attribute: timestamp
conditions:
  - condition: state
    entity_id: input_boolean.stumm
    state:
      - "off"
actions:
  - action: switch.turn_off
    metadata: {}
    data: {}
    target:
      entity_id: switch.tidbyte_xxxxxxx_autodim     <----- Put name of Tidbyt Device here
    enabled: true
  - action: light.turn_on
    metadata: {}
    data:
      brightness_pct: 100
    target:
      entity_id: light.tidbyte_xxxxxxx_brightness     <----- Put name of Tidbyt Device here
  - action: script.katzenfutter_stats
    metadata: {}
    data: {}
  - delay:
      hours: 0
      minutes: 0
      seconds: 10
  - action: switch.turn_on
    metadata: {}
    data: {}
    target:
      entity_id: switch.tidbyte_xxxxxxx_autodim     <----- Put name of Tidbyt Device here
    enabled: true
  - action: light.turn_on
    metadata: {}
    data:
      brightness_pct: 55
    target:
      entity_id: light.tidbyte_xxxxxxx_brightness     <----- Put name of Tidbyt Device here
mode: single

Tronbyt as Host

In Tronbyt you should be able to use the Configuration Scheme given in the app for setup of all arguments!