Skip to content

v1.0.0

Choose a tag to compare

@Geek-MD Geek-MD released this 17 Feb 16:42
· 13 commits to main since this release
cca4c40

v1.0.0 - 2026-02-17

Added

  • Single Instance Configuration: Integration now enforces single-instance configuration

    • Added SINGLE_CONFIG_ENTRY = True to config flow to prevent multiple instances
    • Only one Video Normalizer instance can be configured per Home Assistant installation
    • This ensures proper service and sensor management as they are globally scoped
    • Improves reliability and prevents configuration conflicts
  • Device Registry Integration: Sensor now properly registers as a device

    • Added proper DeviceInfo to the sensor entity
    • Sensor now appears under a dedicated "Video Normalizer" device
    • Improved organization in Home Assistant's device registry
    • Better integration with Home Assistant's device management features
  • Downloader Integration Required: Downloader is now a mandatory dependency

    • Added "downloader" to the dependencies list in manifest.json
    • Config flow now verifies Downloader is installed before allowing configuration
    • Setup will abort with clear message if Downloader is not installed
    • Simplifies configuration by automatically detecting download directory
    • Ensures consistent behavior across all installations

Changed

  • Code Quality Improvements: Enhanced code following Home Assistant best practices

    • Improved type hints across all modules
    • Simplified code structure for better maintainability
    • Enhanced error handling and logging
    • All code passes ruff, mypy, and hassfest validation
  • Sensor Device Integration: Updated sensor initialization to support device registry

    • Sensor now requires config entry for proper device association
    • Device information includes manufacturer, model, and service entry type
    • Better alignment with Home Assistant's entity organization patterns
  • Simplified Configuration Flow: Config flow is now more streamlined

    • Removed recommendation step (Downloader is now required)
    • Directly verifies Downloader installation on configuration start
    • Auto-fills download directory from Downloader configuration
    • Clearer error messages when requirements are not met

Technical

  • Version bumped from 0.6.0 to 1.0.0 (stable release)
  • Enhanced config flow with single-instance enforcement
  • Added DeviceInfo with proper identifiers and metadata
  • Updated sensor to accept ConfigEntry parameter
  • Added dependency verification at config flow start
  • Added new abort reason: downloader_required
  • Updated translations (EN/ES) with new abort message
  • All validation checks passing (ruff, mypy, hassfest)
  • Code reviewed for Home Assistant integration best practices
  • Ready for production deployment

Migration Notes

  • IMPORTANT: Downloader integration is now required
    • If you don't have Downloader installed, install it before upgrading
    • Existing configurations will continue to work if Downloader is present
  • If you have multiple instances configured (not recommended), only one will be active
  • No action needed for users with Downloader already installed
  • The sensor entity ID and unique_id remain unchanged