Skip to content

Media Management

Jump to bottom
Jezza edited this page Sep 19, 2025 · 2 revisions

Media and Video Management

The Petkit integration allows you to access all your media from Petkit devices directly in Home Assistant.

🎞️ Video Clips

🖼️ Image Gallery

📋 Important Media Information

📅 Time Limitation

Media accessible on Home Assistant is ONLY from the current day. It's not possible to download from previous days.

Feature Compatibility

Feature Availability Requirements
🖼️ Photos All devices with camera No subscription required
🎞️ Videos All devices with camera Care+ subscription REQUIRED
📹 Live Stream Not available Not currently supported

⚙️ Media Configuration

Recommended Storage

⚠️ IMPORTANT - External storage recommended

It's strongly recommended to use external storage for media files because:

  • Devices can generate many files
  • Home Assistant storage can fill up quickly
  • Particularly critical if "Retrieve videos" option is enabled

External Storage Configuration

  1. Go to Settings → System → Storage → Add network storage
  2. Mount your external storage
  3. Use the path /your_storage_name in configuration

⚠️ Path Warnings

  • Do NOT use the full path shown in "Remote share path"
  • Paths are case-sensitive
  • Use only the mount name

Configuration Options

Option Description Default Value
Media path Storage directory for files /media
Refresh interval Update frequency (minutes) 5
Retrieve images Enable image downloading Enabled
Retrieve videos Enable video downloading Disabled
Event types Events triggering downloads Eat, Feed, Toileting
Retention Days to keep files 3 (0 = unlimited)

📱 Available Event Types

Food Feeders

  • Eat: Pet eating
  • Feed: Food dispensing
  • Pet: Pet approaching
  • Dish_before: Dish before (picture only)
  • Dish_after: Dish after (picture only)

Automatic Litters

  • Toileting: Litter box usage
  • Pet: Pet approaching
  • Waste_check: Waste_check (picture only)

🗂️ File Organization

Folder Structure

/media/petkit/
└── device_id/
    └── YYYYMMDD/ # date YYYY MM DD
        └── event_type/ # pet, toileting, dish_before, dish_after, feed...
            ├── snapshot/ # snapshot files
            |   ├── [DEVICE_ID]_[TIMESTAMP].jpg
            |   └── [DEVICE_ID]_[TIMESTAMP].jpg
            └── video/ # video files
                ├── [DEVICE_ID]_[TIMESTAMP].avi
                └── [DEVICE_ID]_[TIMESTAMP].avi

Naming Convention

Format: [DEVICE_ID]_[TIMESTAMP].[extension]

Examples:

  • 2025-09-19_eat_001.jpg
  • 2025-09-19_toileting_003.mp4
  • 2025-09-19_feed_012.jpg

🎬 Accessing Media in Home Assistant

Via Media Browser

  1. Go to Media in the sidebar
  2. Navigate to the petkit folder
  3. Browse folders by device and type

Via Dashboard Cards

Media can be integrated into your custom cards for direct access from your dashboard.

🔧 Media Troubleshooting

Common Issues

Media not downloading:

  • Check that corresponding option is enabled
  • Verify Care+ subscription for videos
  • Check available storage space

Path errors:

  • Verify case sensitivity
  • Ensure storage is mounted
  • Use mount name, not full path

Missing media:

  • Media only available for current day
  • Check configured event types
  • Verify refresh interval

Clone this wiki locally