Tuya Recordings 0.3.0 beta 1

Tuya Recordings v0.3.0-beta.1

First public beta of Tuya Recordings for Home Assistant.

Tuya Recordings brings Tuya / Smart Life camera SD-card recording access into
Home Assistant using the Tuya IPC/OpenAPI path. It reuses Tuya Cloud credentials
from LocalTuya, uses the official Tuya integration as the camera inventory, and
caches recordings as private MP4 files under /media.

Highlights

• Tuya / Smart Life SD-card recording discovery through Tuya IPC/OpenAPI.
• Cached MP4 playback through Home Assistant Media Browser.
• Custom Tuya Recordings panel with camera/date browsing, thumbnails, cache
  statistics, storage usage, and sync status.
• Optional background pre-cache mode for instant playback of cached clips.
• Tapo-style on-demand playback when pre-cache is disabled.
• Generated thumbnails from cached MP4 recordings.
• Private video storage under /media, avoiding public /config/www files.
• Status sensors, pre-cache switch, refresh/sync/thumbnail services, and repair
  issues for missing prerequisites.
• Bundled Linux helper binaries for amd64, arm64, and armv7.

Requirements

• Official Home Assistant tuya integration.
• localtuya configured with Tuya Cloud credentials.
• Tuya Developer project linked to the same Tuya / Smart Life account.
• Tuya video/IPC APIs authorized for the project.
• ffmpeg available on the Home Assistant system.
• Tuya / Smart Life cameras with SD cards and recordings.

Installation

Add this repository to HACS as a custom Integration repository:

https://github.com/Wheemer/tuya-recordings

Then install Tuya Recordings, restart Home Assistant, and add it from:

Settings > Devices & services > Add integration > Tuya Recordings

Beta Notes

• Tuya camera support can vary by model, firmware, account, region, and enabled
  Tuya Developer APIs.
• Pre-cache mode only shows clips after both video and thumbnail are ready, so
  playback should start quickly.
• On-demand mode lists discovered clips and caches them when selected.
• Cached media should be stored under a private /media path, not
  /config/www.

Validation

• Full validation passed through tools/validate.ps1.
• Test suite passed: 104 tests.

Helpful Bug Reports Include

• Camera model and firmware version.
• Tuya Recordings version.
• Home Assistant version and install type.
• Tuya OpenAPI region.
• Whether the same clip plays in the Tuya or Smart Life app.
• Diagnostics and relevant Home Assistant log lines.