Tuya Recordings v0.3.0-beta.6

Tuya Recordings v0.3.0-beta.6

Highlights

• Improved camera discovery resilience for non-standard Tuya camera categories.
• Added camera fallback chain (camera-like category/name -> prior cache -> all devices) to avoid empty camera index states.
• Normalized camera and device identifiers (id, deviceId, device_id, and devId) across discovery and playback paths.
• Expanded Tuya OpenAPI get_devices parsing to support wrapped payloads (result, list, devices).
• Added regression tests for get_devices response-shape compatibility.

Validation

• Full validation via tools/validate.ps1.
• Test suite passed: 121 tests.

Tuya Recordings 0.3.0 beta 4

Tuya Recordings v0.3.0-beta.4

Compatibility and safety cleanup after the first public install reports.

Highlights

• Fixes a Home Assistant config-flow crash on 2026.7.x caused by a non-serializable custom validator in the media storage path field.
• Keeps media storage path validation, but now reports normal field errors instead of breaking the config flow form.
• Tightens Pause Tuya camera cloud activity so the panel and Media Browser hide uncached clips while paused instead of presenting items that would fail when selected.
• Adds regression tests for Home Assistant frontend schema serialization and paused cached-only browsing behavior.

Validation

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

Tuya Recordings 0.3.0 beta 3

Tuya Recordings v0.3.0-beta.3

Tuya Recordings 0.3.0 beta 2

Tuya Recordings v0.3.0-beta.2

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.