Skip to content

Releases

v3.6.0-beta.1

v3.6.0-beta.1 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 17 Nov 16:53

☕ Support the Project

If this integration makes controlling your smart home entertainment a breeze, consider supporting continued open-source development:

Support on Ko-fi


🌟 What's New & Highlights

  • A Cleaner Remote & Dashboard Experience:
    • Unified Power Button: We removed the separate Power On and Power Off buttons on cards (#55). You now have a single, clean power button that works just like your physical remote.
    • No More "Ghost" Toggles: Dashboard switches and buttons will no longer flip back and forth if your TV is sleeping or turned off at the wall. Home Assistant now checks if the TV is truly awake before changing states on your screen.
    • Fixed Remote Key Presses: Fixed an issue where repeating keys or rapid button clicks on the remote entity could fail (#70).
    • Older Hisense TV Compatibility: Older models using static credentials (such as the B7100 series) now connect securely over TLS without needing custom certificate files (#71).
  • Helpful, Clear Alerts (No More Silent Failures):
    • If your TV is turned off, unplugged, or disconnected and an action or automation runs, Home Assistant will now clearly tell you (e.g. "TV offline: Device unreachable") instead of failing silently.
    • If your TV loses its pairing after a power outage or firmware update, the TV entity will cleanly show as Unavailable and an Authentication Problem indicator will turn on to let you know right away.
  • Easy Reconnecting & Simple Re-pairing:
    • Force Reconnect Button: If your Wi-Fi dropped out or you restarted your router, clicking Force Reconnect immediately retries the connection without waiting around. If the TV is unreachable, it tells you immediately instead of showing a false green checkmark.
    • Start Re-authentication Button: If you ever need to re-pair your TV, this button creates an item under Settings → System → Repairs and sends you a notification with a direct link to it so you can finish pairing.
  • Smarter TV Turn-On (Wi-Fi + Network Cable):
    • If your TV uses Wi-Fi but also has a network cable plugged in, Home Assistant now automatically remembers both addresses so "Turn On" signals always wake the TV reliably.
  • Hotel Mode Detection:
    • Added a new indicator that warns you if your TV has "Hotel Mode" enabled, which can block app launching or lock volume controls.

🛠️ Technical Details & Refactoring

  • Single Power Toggle & Media Transport Controls (#55):
    • Eliminated split | (Power On) and O (Power Off) buttons when enabling media controls, restoring a unified power standby button (mdi:power-standby) across all Lovelace entity cards and device pages.
    • Retired artificial assumed_state: True flag in favor of dynamic MediaPlayerState.PLAYING / STATE_PAUSED state transitions while media controls are active.
  • Action Exceptions & Reliable Error Surfacing (action-exceptions):
    • Custom domain actions (vidaa.send_key, vidaa.launch_app, vidaa.open_browser, vidaa.send_key_sequence, vidaa.set_tv_setting, and vidaa.select_audio_output) and entity platforms now explicitly raise HomeAssistantError (auth_required, not_connected, turn_on_failed) instead of silent command delivery failures.
    • Action calls return structured execution telemetry ({"success": true/false}) directly to Home Assistant for branching automations.
  • State Integrity & No Optimistic Desync:
    • All TV entity platforms (media_player, remote, select, number, switch, and button) verify live MQTT connection health before sending commands.
    • Controls fail cleanly with descriptive user-facing alerts and avoid optimistic state changes when the TV is powered off or disconnected.
  • Remote Entity Typing & Sanitization (#70):
    • Coerced key_repeat options to integers and sanitized num_repeats handling to prevent typing errors during rapid command sequences.
  • Legacy Static TLS Without Client Certificates (#71):
    • Enabled TLS 1.2 on port 36669 for Legacy Static authentication profiles without requiring client certificates, preventing setup blocks (certs_not_found) and connection timeouts on older models (such as Hisense B7100 series).
  • Diagnostic Maintenance Suite:
    • Renamed trigger_reauth to Start re-authentication (button.<tv>_start_re_authentication), added automatic WoL wake pulse before PIN requests, and added clickable persistent notifications directing to Repairs and Integrations.
    • Enhanced Force reconnect (button.<tv>_force_reconnect) to clear exponential backoff cooldowns, await connection resolution up to 3s, and surface actionable errors instead of false positive completions.
    • Added Probe capabilities button (button.<tv>_probe_capabilities) to actively query picture and sound menu capabilities over MQTT.
    • Added Authentication problem sensor (binary_sensor.<tv>_authentication_problem) and Hotel mode sensor (binary_sensor.<tv>_hotel_mode).
  • Dual MAC Address Auto-Extraction & Wake-on-LAN:
    • Automatically parses both Wi-Fi (macWifi) and Ethernet (macEthernet) MAC addresses from UPnP descriptors and matches the active ARP interface.
    • Automatically populates secondary_mac_address in config entries and setup flows, allowing Wake-on-LAN packets to target both interfaces seamlessly.
  • Cold Boot & Mains Power Cut Resilience:
    • Tested and hardened token invalidation recovery when TVs undergo abrupt mains power cuts (Mosquitto RC 134 rejection), ensuring clean transitions to unavailable and automated repair prompt creation.
  • Standalone CLI Diagnostics & Zero-Setup Runner:
    • Decoupled core client modules from Home Assistant test stubs, allowing standalone troubleshooting tools (scripts/test_client.py and scripts/diag.sh) to run in bare Python environments.
    • Added real-time /remoteapp/# wildcard packet sniffing (sniff command) for OEM debugging.
  • Test Suite Modularization & 2026.11 Naming Alignment:
    • Modularized platform test files into dedicated modules (test_media_player_actions.py, test_media_player_sources.py).
    • Strict compliance with Home Assistant 2026.11 entity naming standards (_attr_has_entity_name = True, leaving entity names clean and relying on device/area context).

💬 Feedback & Bug Reports

Please report any issues or feedback on GitHub Issues or Discussions!

v3.5.1

Choose a tag to compare

@github-actions github-actions released this 14 Nov 14:55

☕ Support the Project

If this integration makes controlling your smart home entertainment a breeze, consider supporting continued open-source development:

Support on Ko-fi

🐛 Bug Fixes & Improvements

  • CLEAN HOME ASSISTANT STARTUP (No More IntegrationNotFound Warning):
    • Fixed a startup error (Failed to load services.yaml for integration: hisense_vidaa) that appeared after migrating to v3.5.0 and removing the old folder.
    • Legacy action aliases (e.g. hisense_vidaa.send_key) now register full schema descriptions directly with Home Assistant, keeping your startup logs clean and your existing automations running smoothly (#66).
  • SMART STANDBY DETECTION & HDMI EXTERNAL DEVICES:
    • Fixed an issue where projectors (such as TOPTRO) or TVs with external streaming boxes (like Apple TV or Chromecast) falsely showed as "on" in Home Assistant after a restart while the display was actually in standby (#61).
    • Toggling power off now reliably turns off the device rather than accidentally turning it on when HDMI signals remain active (#61).
    • Improved live power state synchronization so running TVs that wake up during a restart are recognized instantly without delays (#53).
  • SIMPLIFIED KEYSTORE EXTRACTION:
    • Updated documentation to highlight the standard res/raw/client_mobile_android.p12 keystore path found when unzipping official companion APKs, saving time for new users (#65).
  • SMART SERVICES PAIRING NOTICE:
    • Added clear setup guidance explaining that TV "Smart / Connected Services" must be accepted in TV settings for the 4-digit pairing PIN to display on screen, alongside router firewall tips for complete local-only isolation (#64).

v3.5.0

Choose a tag to compare

@github-actions github-actions released this 14 Nov 05:24

This major milestone rebrands the integration to VIDAA Smart TV (vidaa), celebrating full universal support across all TV and projector manufacturers powered by VIDAA OS (Hisense, Toshiba, Loewe, Philips, Sharp, JVC, TOPTRO, and regional brands).

☕ Support the Project

If this integration makes controlling your smart home entertainment a breeze, consider supporting continued open-source development:

Support on Ko-fi

🌟 What's New & Highlights in v3.5.0

  • UNIVERSAL VIDAA REBRAND (vidaa):
    • Rebranded the integration domain to vidaa and integration title to VIDAA Smart TV.
    • Added official VIDAA iconography, vibrant high-res logos, and brand artwork.
    • Complete native localization across 11 languages (de, es, fr, it, pt, pt-BR, ru, sr, sr-Latn, uk, zh-Hans).
    • Seamlessly refactored all internal classes to Vidaa* while preserving backwards-compatible aliases for custom scripts.
  • ZERO-EFFORT AUTOMATIC MIGRATION (No Re-Pairing Needed):
    • Automatic Setup Upgrade: Existing TVs automatically upgrade from configuration v1 to v2.1—no need to enter PINs or re-pair.
    • Preserved Dashboards & Names: All entity IDs, custom names, area assignments, and dashboard cards are preserved seamlessly.
    • Backward-Compatible Automations: All existing hisense_vidaa.* actions and device triggers continue working alongside the new canonical vidaa.* actions.
    • Clean Up Alerts: Includes a friendly Home Assistant Repairs notification to help you safely delete the obsolete hisense_vidaa folder after upgrading.
  • HDMI-CEC INPUT DISCOVERY & DEVICE NAMES:
    • Friendly Input Names: Your TV now automatically discovers and shows friendly names for connected HDMI devices (e.g., HDMI 1 (Chromecast) or HDMI 2 (PlayStation 5)) in your source list.
    • Direct Device Selection: Switch directly by selecting the device name from the dropdown.
    • Cleaned up attributes so inputs display neatly without repeating names.
  • SMART AUTO POWER-ON:
    • Selecting an input or playing media while your TV is off or in standby will now automatically wake and turn on the TV for you.
  • STREAMLINED AUDIO ROUTING:
    • Audio output is now cleanly reported as an audio_output attribute on your TV (TV Speakers or ARC / eARC), retiring clunky standalone select entities.
  • SLEEK MEDIA PLAYER CONTROLS:
    • Media playback buttons (Play/Pause/Track) are now disabled by default to keep TV cards sleek and minimal. You can easily toggle them on anytime under Configure → Sources & Media.
    • Restored persistent Previous/Next track and channel navigation buttons when media controls are active (#55).
  • ACCURATE HOME LAUNCHER & TV INPUT DETECTION:
    • Added smart detection for the VIDAA Home screen (remote_launcher), accurately reporting when you return to the home screen.
    • Fixed TV input sensors on restart so your TV never gets falsely stuck on "Standby" when turned on to an HDMI port.
  • UNIFIED DIAGNOSTICS:
    • Consolidated diagnostic sensors into a single, clean Session Status sensor (sensor.<tv>_session_status), decluttering your entity list.
    • Cleaned up hardware attributes (MAC address, model, software version) so they live properly in the Device Info card where Home Assistant expects them.
  • REMOTE KEYBOARD & TEXT INPUT:
    • Added virtual text typing to remote.send_command using the text:<string> prefix, making on-screen searches and typing fast from automations and scripts.
  • PERFORMANCE & FUTURE-PROOFING:
    • Non-blocking clock synchronization via UPnP HTTP executor threads (#59).
    • Full Python 3.14 and Python 3.16 compatibility.
    • Filtered duplicate discovery prompts when a TV is already configured on your network.

v3.3.2-beta.1

v3.3.2-beta.1 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 07 Nov 19:46

This beta pre-release resolves an issue where the Home Assistant media player card would hide the Previous and Next track/channel buttons when the TV was turned on.

🌟 What's New & Fixed in v3.3.2-beta.1

  • MEDIA PLAYER UI CONTROLS (#55):
    • Fixed an issue where Home Assistant hid Previous/Next track and channel navigation buttons in the media player card while the TV is on.
    • Controls now remain visible and accessible whenever media playback controls are enabled.

v3.3.1

Choose a tag to compare

@github-actions github-actions released this 07 Nov 19:15

This release resolves a critical Wake-on-LAN broadcast regression across subnets and relays, fixes a UI setup error (not_implemented) during initial device pairing, expands regional smart TV streaming app aliases for top analytics countries, adds full native translations for Russian, Ukrainian, and Simplified Chinese, and introduces multilingual documentation with dark-mode badges.

☕ Support the Project

If this integration has added value to your smart home setup, consider buying me a coffee to support continued development and maintenance:

Support on Ko-fi

🌟 What's New & Fixed in v3.3.1

  • WAKE-ON-LAN BROADCAST DISPATCH (#52):
    • Keyword Argument Preservation: Switched executor dispatch in tv/actions.py to use functools.partial(client.send_wake_on_lan, mac_targets, ip=getattr(client, "ip", None)) instead of passing IP positionally.
    • Dual Broadcast Recovery: Restored broadcast packet delivery to both standard 255.255.255.255:9 and subnet-directed <subnet>.255:9 alongside direct unicast, resolving power-on failures from deep standby across subnets and UDP relays (verified on Hisense PX3-Pro).
  • STANDBY & SIGNAL GUARDING (#53):
    • Guarded KEY_POWER toggling and active signal detection during TV fake sleep/standby transitions.
  • CONFIG FLOW MRO INHERITANCE BUG FIX:
    • Reordered class inheritance in HisenseVidaaConfigFlow (DiscoveryFlowMixin, ReauthFlowMixin, CertsFlowMixin, UserFlowMixin, config_entries.ConfigFlow) so custom mixin implementations precede Home Assistant core stubs.
    • Eliminates the not_implemented error dialog when adding or reconfiguring TVs in the UI.
  • INTERNATIONALIZATION & NEW TRANSLATIONS:
    • Added complete 100% key-parity translations for Russian (ru.json), Ukrainian (uk.json), and Simplified Chinese (zh-Hans.json).
    • Added dark-mode friendly SVG language switcher badges in README.md and created localized README guides in docs/i18n/ for German, Italian, French, Russian, Ukrainian, and Simplified Chinese.
  • REGIONAL SMART TV APP ALIASES:
    • Added streaming app aliases for France (France.tv, TF1+, 6play, Canal+), Germany & Austria (WOW, MagentaTV, Zattoo, ServusTV), Italy (TIMVISION), Eastern Europe & Ukraine (MEGOGO, Sweet.tv, Kyivstar TV), Russia (Kinopoisk, IVI, Okko, Wink, KION), China (iQIYI, Tencent Video, Youku, Bilibili, Mango TV), and Canada (TSN, Sportsnet, ICI TOU.TV).
  • DEVELOPER TOOLING & REPOSITORY HYGIENE:
    • Relocated CLI utilities (test_client.py, debug_tv.py) to repository root scripts/ to ensure they are excluded from HACS production zip releases.
    • Hardened unit tests and CI workflow with hermetic mocks and voluptuous installation across Python 3.12 and 3.13.

v3.3.1-beta.1

v3.3.1-beta.1 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 07 Nov 16:56

🧪 v3.3.1-beta.1 Pre-Release Test Build

This pre-release includes critical fixes for Wake-on-LAN and integration setup, regional streaming app additions, complete translations for top user countries, and multilingual documentation.


⚡ Fixes & Core Improvements

  • Wake-on-LAN Broadcast Dispatch (#52):
    • Resolved argument passing in the executor call (functools.partial(client.send_wake_on_lan, ..., ip=...)), restoring broadcast dispatching to both standard 255.255.255.255:9 and subnet-directed <subnet>.255:9.
    • Fixes power-on failures from deep standby across subnets / UDP relay environments.
  • Standby & Power State Guarding (#53):
    • Guarded KEY_POWER toggling and active signal state detection during TV fake sleep/standby transitions.
  • Config Flow Setup MRO Bug Resolved:
    • Corrected class inheritance order in HisenseVidaaConfigFlow (DiscoveryFlowMixin, ReauthFlowMixin, CertsFlowMixin, UserFlowMixin, config_entries.ConfigFlow).
    • Resolves the "not_implemented" dialog when adding or reconfiguring TVs in the Home Assistant UI.
  • Context-Aware Media Player Controls (#55):
    • Remote next/previous track controls intelligently map to Live TV channel navigation (KEY_CHANNELUP / KEY_CHANNELDOWN) when watching broadcast television, and media track skipping inside streaming apps.
  • On-Screen Notifications (#54):
    • Added support for sending toast messages directly to VIDAA TV screens via the notify entity.

🌐 Internationalization & Regional Smart TV Apps

  • New Translations:
    • Added complete 100% key-parity translations for Russian (ru.json), Ukrainian (uk.json), and Simplified Chinese (zh-Hans.json).
    • Added Serbian Cyrillic & Latin translations (thanks @cpmarexel2f in #50).
  • Regional App Aliases Expanded:
    • France: France.tv, TF1+, 6play, Canal+
    • Germany & Austria: WOW, MagentaTV, Zattoo, ServusTV
    • Italy: TIMVISION
    • Ukraine & Eastern Europe: MEGOGO, Sweet.tv, Kyivstar TV
    • Russia: Kinopoisk, IVI, Okko, Wink, KION
    • China: iQIYI, Tencent Video, Youku, Bilibili, Mango TV
    • Canada: TSN, Sportsnet, ICI TOU.TV
  • Multilingual Documentation (docs/i18n/):
    • Added dark-mode friendly SVG language switcher badges in README.md.
    • Added localized READMEs in German, Italian, French, Russian, Ukrainian, and Simplified Chinese.

🛠️ Developer Tooling & Packaging

  • Clean Repository Structure: Moved standalone developer testing tools (test_client.py, debug_tv.py) into root scripts/ to ensure they are never bundled into the HACS production zip.
  • Hermetic Test Suite: All 297 unit tests passing across Python 3.12 and 3.13.

📦 How to Test via HACS

  1. In Home Assistant, open HACS → Integrations → Hisense VIDAA TV.
  2. Click the three dots menu (⋮) in the top right corner and enable "Show beta".
  3. Click Redownload, select v3.3.1-beta.1, click Download, and restart Home Assistant.

v3.2.0

Choose a tag to compare

@github-actions github-actions released this 05 Nov 11:55

This release expands the integration beyond Hisense-badged hardware to provide comprehensive, end-to-end support for all partner TV brands operating on the VIDAA Smart TV platform (including Toshiba, Loewe, TPV Technology / Philips, Schneider, Akai, Beko, and others). It also introduces robust client SSL certificate semantic and syntactic validation, enriched async UPnP descriptor parsing, and graceful Zeroconf / HomeKit metadata extraction.

☕ Support the Project

If this integration has added value to your smart home setup, consider buying me a coffee to support continued development and maintenance:

Support on Ko-fi

🌟 What's New & Hardened in v3.2.0

  • UNIVERSAL VIDAA OEM MULTI-BRAND SUPPORT:
    • Full cryptographic and lifecycle support for all licensed partner TV brands running VIDAA OS: Hisense (his), Toshiba (tos), Loewe / We. by Loewe (loe), TPV Technology / Philips / AOC (tpv), Sharp (shp), JVC (jvc), Schneider (sch), Akai (aka), Beko (bek), Telefunken (tel), Bush (bus), Vizio (vic), Philco (phi), Noblex (nob), Sansei (san), RCA (rca), Sinotec (sin), Vestel (ves), Brandt (bra), Metz (met), and Leica (lei).
    • Post-PIN Brand Overwrite Prevention (flow_helpers.py, config_flow.py): Fixed a critical bug where post-PIN device discovery defaulted to "his" and unconditionally clobbered a cascade- or cert-hinted OEM brand (tos, loe, tpv, shp, jvc) when UPnP was blocked across isolated VLANs or omitted brand=.
    • Dynamic Client Credential Regeneration on Brand Change (client.py, __init__.py): Changing the TV OEM brand in Options Flow or setup now automatically derives fresh brand-scoped pairing credentials (client_id, username, password) and invalidates stale tokens on HisenseTvClient, persisting the new credentials cleanly to entry.data.
    • Expanded Candidate OEM Brand Handshake Cascade (protocol/pairing.py): When pairing over manual IP or isolated IoT VLANs without UPnP discovery, if the broker rejects the initial connection with rc: 5 (Not Authorized), the pairing engine automatically cascades through high-probability candidate brands (tos, loe, tpv, shp, jvc), auto-adopting the accepted brand and updating the Home Assistant device registry.
    • Automatic OEM Brand Detection from Certificate Filenames (protocol/certs.py): Added detect_brand_from_cert_paths(). Placing brand-named certificates in /config/ssl/ (e.g. toshiba.crt, loewe.pem, philips.crt, sharp.pem, jvc.key, rcamobile.p12) automatically hints the TV manufacturer and pre-configures the dynamic OEM salt.
    • Manual IP Setup & Device Options Brand Selectors (config_flow.py, options_flow.py): Added CONF_BRAND selector dropdown to both the initial manual IP setup step and the Security Options menu, allowing users to explicitly select their TV OEM brand upfront or adjust it later.
    • Canonical Brand Normalization & 3-Letter Code Preservation (discovery.py): Updated normalize_brand_code() to tokenize word boundaries, avoiding false substring collisions (e.g. preventing "unrecognized_brand" from matching "bra" Brandt), while preserving explicit 3-letter alphanumeric codes (brand=xyz) from UPnP <modelDescription>.
    • UPnP Descriptor MAC Fallbacks (tv/upnp_desc.py, protocol/upnp.py): Supported mac and network_device as fallback MAC keys in UPnP XML descriptors alongside macWifi.
    • Brand-Aware Diagnostics & Sensor Fallbacks (sensors_diagnostic.py, tv/probe.py, client.py): Diagnostic sensors, default friendly names, and probe Markdown reports now dynamically reflect the resolved TV OEM brand rather than hardcoding "Hisense".
    • CLI Diagnostics Multi-Brand Support: Added --brand parameter to test_client.py and debug_tv.py with open brand support.
  • TOPTRO SMART PROJECTOR SUPPORT & OEM BRAND PROPAGATION (const.py, discovery.py, protocol/auth.py, protocol/pairing.py, client.py):
    • Added official OEM brand support for TOPTRO portable smart projectors running VIDAA OS (e.g. FreeStyle series), mapping tpo and toptro across BRAND_OPTIONS, BRAND_MAP, and BRAND_CODE_MAP.
    • Expanded the pairing cascade fallback candidate list to automatically probe tpo alongside tos, loe, tpv, shp, and jvc when initial connections to projector brokers fail.
    • Enhanced async_probe_tv_auth_methods() and HisenseTvClient.async_probe_auth_methods() to propagate synchronized device clock timestamps (timestamp=int(time.time()) + self.clock_offset) and active OEM brand prefixes.
    • Hardened MQTT diagnostic classification across both MQTT 3.1.1 (rc: 4, rc: 5) and MQTT 5.0 (rc: 134, rc: 135) using AUTH_REJECTION_CODES, ensuring bad credentials and permission rejections are cleanly reported as "not_authorized" rather than generic network connection errors.
    • Dynamic brand refresh in pairing handshake: auto-detects and updates client.brand from UPnP descriptor fingerprints before pairing if client.brand is still at default ("his"), safeguarding manual brand overrides.
  • "AUTO-DETECT" BRAND OPTION & DEDICATED BRAND PROFILE DIAGNOSTIC SENSOR (const.py, config_flow.py, sensor.py, sensors_diagnostic.py, flow_helpers.py, flow_reauth.py, options_flow.py, translations/*.json):
    • Added "auto": "Auto Detect (Recommended)" as the default option in the setup and options brand selectors (BRAND_OPTIONS, DEFAULT_BRAND_OPTION), matching the authentication profile UX.
    • Streamlined manual setup: users only need to type their TV/projector IP address; the integration queries the UPnP descriptor on port 38400, extracts brand=... from <modelDescription>, normalizes the code, and resolves OEM branding with zero manual intervention.
    • Added a dedicated diagnostic entity: HisenseVidaaBrandProfileSensor (sensor.<device>_brand_profile), displaying the configured brand profile (Auto Detect (Recommended), Hisense, Toshiba, TOPTRO, etc.) along with diagnostic attributes (configured_profile, active_brand_code, active_brand).
    • Added localized translations for brand_profile and selector options across English, German, Spanish, French, Italian, and Portuguese (en.json, de.json, es.json, fr.json, it.json, pt.json, pt-BR.json).
  • SSL CLIENT CERTIFICATE INTEGRITY VALIDATION (protocol/certs.py):
    • Implemented strict PEM certificate and private key validation via validate_ssl_certs().
    • Validates BEGIN/END headers, Base64 decoding, ASN.1 structure, modulus matching between certificate and private key, and PKCS#8 decryption without hard external cryptography dependencies.
    • Provides clear, actionable error feedback when invalid or mismatched certificates are uploaded during manual certificate setup.
    • Clarified universal app architecture in documentation: the official VIDAA Smart TV app (com.universal.remote.multi) is universal across all brands and its client certificate (CN=VidaaAppAndroidV01) authenticates with any VIDAA OS TV.
  • EVENT LOOP NON-BLOCKING CERTIFICATE RESOLUTION & PKCS#12 CACHING (__init__.py, client.py, protocol/certs.py, config_flow.py, flow_reauth.py):
    • Resolves GitHub issue #49 (Detected blocking call to open with args inside the event loop).
    • Offloaded certificate path searches, resolve_certificates(), and resolve_ca_certificate() in async_setup_entry to Home Assistant's threadpool executor via hass.async_add_executor_job().
    • Hardened HisenseTvClient.__init__ to skip disk certificate scans and resolution entirely when use_ssl=False, for legacy/static auth profiles, or when valid pre-resolved PEM certificate and key paths are supplied.
    • Added timestamp-based (mtime) disk caching in extract_pkcs12_to_pem() to reuse existing extracted PEM certificate and key files on subsequent startups without re-reading the .p12 archive, performing write-access probe checks, or rewriting files.
    • Ensured _async_resolve_ssl_certs() runs in the executor before client initialization in all config flow and re-authentication paths.
  • ASYNC UPnP <modelDescription> CAPABILITY EXTRACTION (protocol/upnp.py):
    • Enhanced HisenseUpnpClient.async_get_device_fingerprint() to parse <modelDescription> as key-value pairs, extracting brand, platform, vidaa_support, voice, transport_protocol, mac_wifi, and mac_ethernet asynchronously.
  • ZEROCONF / HOMEKIT mDNS METADATA ENRICHMENT (discovery.py):
    • Enriched parse_zeroconf_discovery() to extract actual model names (md/model) and manufacturer branding from mDNS TXT properties advertised by Apple HomeKit / AirPlay (_hap._tcp.local., _airplay._tcp.local.).
    • Completely decoupled from control: graceful fallback to defaults if HomeKit/AirPlay is disabled or properties are absent.
  • TEST SUITE MODULARIZATION & EXPANSION (262 PASSING TESTS):
    • Decoupled oversized test suites into modular, single-responsibility modules:
      • Split test_client_auth.py into test_client_tokens.py (token lifecycle/drift/standby), test_client_reconnect.py (reconnect locks/backoff/rejection thresholds), and test_client_auth.py (core auth profiles/probing).
      • Split test_pairing.py into test_pairing_guards.py (abort flow/duplicate guards), test_pairing_cascade.py (brand fallback cascade/profile fallback), and test_pairing.py (PIN challenge probing/flows).
      • Split test_services.py into test_services_targeting.py (device/area/floor/label resolution & guards) and test_services.py (service executions).
      • Added test_multi_brand_readiness.py covering OEM brand select...
Read more

v3.1.0

Choose a tag to compare

@github-actions github-actions released this 01 Nov 15:27

This release marks a major architectural milestone for the Hisense VIDAA TV integration, completing a full migration to native async MQTT (aiomqtt>=2.3.0), eliminating all threaded callbacks and executor offloading, modernizing Lovelace remote card designs, standardizing documentation examples, and achieving complete architectural compliance with all 54 Home Assistant Integration Quality Scale rules in quality_scale.yaml.

☕ Support the Project

If this integration has added value to your smart home setup, consider buying me a coffee to support continued development and maintenance:

Support on Ko-fi

🌟 What's New & Hardened in v3.1.0

  • NATIVE aiomqtt>=2.3.0 ASYNC TRANSPORT ENGINE (async-dependency: done):
    • Replaced legacy threaded paho-mqtt (loop_start() / loop_stop(), threading.Timer, threading.Lock, threading.Thread, and cross-thread hass.loop.call_soon_threadsafe) with native aiomqtt.Client async context managers running directly on Home Assistant's event loop.
    • Replaced synchronous locks and thread sleeps with asyncio.Task, asyncio.Lock, and asyncio.Future query routing for snappy, non-blocking TV state requests and commands.
    • Eliminated unnecessary hass.async_add_executor_job invocations across all platforms (media_player, remote, button, switch, select, number, notify, services).
  • SHARED aiohttp.ClientSession WEBSESSION INJECTION (inject-websession: done):
    • Injected Home Assistant's shared aiohttp.ClientSession via async_get_clientsession(hass) into HisenseTvClient and HisenseUpnpClient.
    • Added non-blocking async UPnP HTTP Date header synchronization (async_get_tv_timestamp) and device fingerprinting (async_get_device_fingerprint), replacing legacy urllib.request.urlopen.
  • LOVELACE REMOTE EXAMPLES & DARK MODE MODERNIZATION (examples/):
    • Optimized examples/lovelace-australian-remote-card.yaml and examples/lovelace-us-remote-card.yaml for Home Assistant dark mode and browser rendering engines.
    • Added keep config (background: true, box_shadow: true, border_radius: true) to custom:stack-in-card to eliminate seam artifacts between card segments.
    • Protected buttons against Chrome/Blink auto-dark-mode contrast inversion with forced-color-adjust: none and color-scheme: light.
    • Enhanced Australian remote with authentic Stan branding, white pill styling for streaming apps, glowing borders, and 3D tactile gradients on colored navigation buttons.
    • Redesigned power button with circular recessed styling and illuminated red status icon.
    • Updated high-resolution brand assets (brand/icon@2x.png, brand/logo@2x.png) and integration screenshots.
  • STANDARDIZED ENTITY IDS ACROSS EXAMPLES & AUTOMATION DOCS (examples/, docs/):
    • Standardized entity IDs to living_room_hisense_vidaa_tv across all 6 Lovelace card examples (australian-remote, us-remote, classic-remote, button-card-remote, android-tv-card, tv-card) and throughout docs/services_and_automations.md.
  • MULTI-DEVICE SERVICE TARGET AMBIGUITY GUARD (services_target.py):
    • Safeguarded custom services (send_key, launch_app, send_text_input, set_picture_setting, set_sound_setting, send_key_sequence, change_channel) from unintended broadcast when multiple TVs are present.
    • Single configured TV: Automatically executes without requiring target selectors (zero breaking changes for single-TV homes).
    • Multiple configured TVs without target: Raises ServiceValidationError (ambiguous_target) prompting for specific target.
    • Multi-TV broadcast: Explicitly broadcast to all configured TVs using entity_id: "all".
    • Full localization added across 7 languages (en, de, es, fr, it, pt, pt-BR) in strings.json and translation catalogs.
  • TV USB POWER LIMITATIONS & STANDBY BROWNOUT DOCUMENTATION (docs/power_and_standby_settings.md):
    • Documented volatile token memory wipes caused by external streaming sticks (Chromecast, Fire TV, Roku) powered by TV USB ports during standby transitions, providing power and standby mitigation instructions.
  • PROTOCOL & EVENT LOOP RUNTIMEWARNING FIX (protocol/ping.py):
    • Closed unspawned coroutines cleanly when the event loop is absent to eliminate Python RuntimeWarning messages in test harnesses and standalone scripts.
  • INTEGRATION QUALITY SCALE ALIGNMENT (quality_scale.yaml):
    • Formally achieved 100% rule compliance across all 54 Bronze, Silver, Gold, and Platinum rules in quality_scale.yaml (async-dependency, inject-websession, strict-typing, reconfiguration-flow, runtime-data).
    • Conservatively retains manifest.json at "quality_scale": "bronze" in accordance with Home Assistant Core staged review policy.
  • EXPANDED TEST SUITE (224 TESTS PASSING):
    • Expanded unit test coverage across async MQTT lifecycle, proactive token refresh in standby, multi-device ambiguity guards, Websession retention, and Hassfest container verification.

v3.0.0

Choose a tag to compare

@github-actions github-actions released this 28 Oct 15:32

This milestone release celebrates surpassing 1,000 active downloads on HACS in just over a week! A heartfelt thank you to our vibrant open-source community, early contributors, and everyone who filed issues, tested hardware edge cases, and helped refine the integration.

PR's: @Syax89 @mzhur
Issues: @cyranius669 @Mrgrafcox @ThatCKx @yagoid @lvbubi @ndesgranges
(Special thanks also to everyone in the Home Assistant community who submitted anonymous diagnostic traces and starred the repository!)

☕ Support the Project

If this integration has added value to your smart home setup, consider buying me a coffee to support continued development and maintenance:

Support on Ko-fi

🌟 What's New & Hardened in v3.0.0

  • LIVE MQTT DEVICE REGISTRY ENRICHMENT & GENERIC PLACEHOLDER SANITIZATION (discovery.py, tv/state.py, entity.py, __init__.py):
    • Sanitized generic UPnP <manufacturer>SmartTV</manufacturer> placeholders using brand codes (BRAND_MAP) parsed from SSDP model descriptions.
    • Dynamically bound device_info in HisenseVidaaEntity to live telemetry attributes (model_name, manufacturer, firmware_version), falling back to config entry values.
    • Implemented real-time async_update_device callback on incoming getdeviceinfo and gettvinfo MQTT telemetry, with clean unload unregistration.
    • Updated device registry lookup to use modern async_get_device_by_identifier with backwards-compatible fallback, preventing deprecation warnings in HA 2025.1+.
  • DYNAMIC MDI APP & SOURCE ICON BRANDING (media_player.py):
    • Added dynamic icon property to HisenseVidaaMediaPlayer resolving active sources and Smart TV streaming applications (Netflix, YouTube, Prime Video, Disney+, Plex, Spotify, Apple TV, Browser, HDMI ports, Live TV, AV) to intuitive MDI icons.
  • MULTI-BRAND VIDAA OS PROTOCOL FOUNDATION (crypto.py, client.py, flow_discovery.py):
    • Parameterized the brand identifier across pairing handshake, dynamic username generation, client ID formatting, and password hashing ("his", "tos", "loe", "sch", "aka", "bek", "tel", "bus", "vic"), laying the groundwork for the upcoming universal VIDAA integration rebrand.
  • INTEGRATION QUALITY SCALE (GOLD TIER) HARDENING & EXPANDED DOCUMENTATION:
    • Implemented async_remove_config_entry_device in __init__.py for stale device cleanup (stale-devices).
    • Added formal tracking file quality_scale.yaml documenting adherence across Bronze, Silver, and Gold IQS rules.
    • Pinned manifest.json to Bronze pending official staged review by Home Assistant Core reviewers.
    • Expanded documentation across docs/README.md, docs/parameters.md (local push architecture, supported entities, known limitations), and docs/services_and_automations.md (real-world automation recipes for cinema mode, gaming mode sync, doorbell toast alerts, and late-night audio guard).
  • TEST SUITE EXPANSION:
    • Expanded unit test suite to 221 tests passing across stale device removal, dynamic source icons, brand credentials derivation, deprecation-free device registry enrichment, and telemetry parsing.

v2.11.1

Choose a tag to compare

@github-actions github-actions released this 20 Oct 18:28
  • MASK SENSITIVE MQTT TOKENS IN DEBUG LOGS (protocol/dispatcher.py, protocol/auth.py, protocol/pairing.py):
    • Implemented mask_sensitive_payload and mask_sensitive_data to ensure accesstoken, refreshtoken, access_token, refresh_token, passwords, and secrets are sanitized (***) in Home Assistant debug logs when debug logging is active.
    • Masked incoming MQTT payload logging in dispatch_incoming_mqtt_message on token topics (tokenissuance, gettoken), while preserving non-sensitive diagnostic integers (accesstoken_duration_day, accesstoken_time).
    • Added fallback redaction ([payload masked]) for non-JSON or malformed payload strings on token topics, and regex-based fallback for broken JSON.
    • Masked token payload debug logging in perform_token_refresh standalone refresh client (on_token_message).
    • Masked PIN response payloads and exception error strings in protocol/pairing.py.
  • HOME ASSISTANT DIAGNOSTICS WIRE-KEY REDACTION (diagnostics.py):
    • Added wire-format payload keys "accesstoken" and "refreshtoken" to TO_REDACT in diagnostics.py to ensure diagnostics downloads redact tokens across all key naming variations.
  • CLI DIAGNOSTIC TOOL REDACTION SAFEGUARDS (test_client.py):
    • Masked stdout token printing in test_client.py (*** (valid X days)) to prevent accidental token exposure when users paste terminal troubleshooting outputs into public GitHub issues.
  • AUTOMATED SENSITIVE DATA LOGGING TEST SUITE (tests/test_dispatcher.py, tests/test_diagnostics.py):
    • Added comprehensive unit tests with pytest caplog fixture verifying that debug logs never leak raw access or refresh tokens across dispatch, refresh, and diagnostics platforms, expanding test suite to 215 tests.