Klydo Clock 0.1.0 — ADB MVP

Initial Home Assistant integration for the stock Klydo Clock, installable as a HACS custom repository.

Included

• UI setup, options, and address reconfiguration with stable device IDs.
• Next, previous, and refresh buttons.
• Connection, running/foreground, app version, and free-storage status.
• Local asynchronous ADB, bounded reconnect backoff, command serialization, and redacted diagnostics.

Install

Add https://github.com/chstech1/klydo-clock-ha in HACS → Custom repositories, choose Integration, download Klydo Clock, and restart Home Assistant. Then add Klydo Clock under Settings → Devices & services using the clock's address and ADB port (normally 1379). Requires Home Assistant 2026.9.0+.

The attached ZIP is for manual installation; extract its custom_components/klydo_clock directory into Home Assistant's configuration directory. HACS uses the tagged repository source automatically.

Validation

• 54 automated tests pass, 96% coverage, with sockets disabled.
• Ruff lint and formatting pass.
• Home Assistant 2026.9.0 Hassfest: one integration, zero invalid integrations.
• Stock Android 8.1/PX30 clock, app 623.3: 100 consecutive read-only polls and explicit disconnect/reconnect pass.

Limits

Actual HACS installation on the owner's Home Assistant instance, real device reboot/Wi-Fi-outage recovery, and upgrade/rollback across two releases still need acceptance testing. Display controls, night mode, app lifecycle, and targeted animation selection are deferred pending the source plan's validation gates. This is the initial MVP, not completion of the full roadmap.

The GitHub validation workflow is now active on the default branch, covering tests, lint, Hassfest, and HACS validation. The HACS package is public and versioned.

Network requirement: the tested clock exposes unauthenticated root ADB access. Restrict its ADB port to Home Assistant and trusted administrators; never expose it to the internet. Firewall isolation has not been independently verified.