Repository navigation
Releases
v3.6.0-beta.1
☕ Support the Project
If this integration makes controlling your smart home entertainment a breeze, consider supporting continued open-source development:
🌟 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) andO(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: Trueflag in favor of dynamicMediaPlayerState.PLAYING/STATE_PAUSEDstate transitions while media controls are active.
- Eliminated split
- 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, andvidaa.select_audio_output) and entity platforms now explicitly raiseHomeAssistantError(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.
- Custom domain actions (
- State Integrity & No Optimistic Desync:
- All TV entity platforms (
media_player,remote,select,number,switch, andbutton) 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.
- All TV entity platforms (
- Remote Entity Typing & Sanitization (#70):
- Coerced
key_repeatoptions to integers and sanitizednum_repeatshandling to prevent typing errors during rapid command sequences.
- Coerced
- 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).
- Enabled TLS 1.2 on port 36669 for Legacy Static authentication profiles without requiring client certificates, preventing setup blocks (
- Diagnostic Maintenance Suite:
- Renamed
trigger_reauthto 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).
- Renamed
- 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_addressin config entries and setup flows, allowing Wake-on-LAN packets to target both interfaces seamlessly.
- Automatically parses both Wi-Fi (
- 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
unavailableand automated repair prompt creation.
- Tested and hardened token invalidation recovery when TVs undergo abrupt mains power cuts (Mosquitto RC 134 rejection), ensuring clean transitions to
- Standalone CLI Diagnostics & Zero-Setup Runner:
- Decoupled core client modules from Home Assistant test stubs, allowing standalone troubleshooting tools (
scripts/test_client.pyandscripts/diag.sh) to run in bare Python environments. - Added real-time
/remoteapp/#wildcard packet sniffing (sniffcommand) for OEM debugging.
- Decoupled core client modules from Home Assistant test stubs, allowing standalone troubleshooting tools (
- 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).
- Modularized platform test files into dedicated modules (
💬 Feedback & Bug Reports
Please report any issues or feedback on GitHub Issues or Discussions!
v3.5.1
☕ Support the Project
If this integration makes controlling your smart home entertainment a breeze, consider supporting continued open-source development:
🐛 Bug Fixes & Improvements
- CLEAN HOME ASSISTANT STARTUP (No More
IntegrationNotFoundWarning):- Fixed a startup error (
Failed to load services.yaml for integration: hisense_vidaa) that appeared after migrating tov3.5.0and 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).
- Fixed a startup error (
- 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.p12keystore path found when unzipping official companion APKs, saving time for new users (#65).
- Updated documentation to highlight the standard
- 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
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:
🌟 What's New & Highlights in v3.5.0
- UNIVERSAL VIDAA REBRAND (
vidaa):- Rebranded the integration domain to
vidaaand 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.
- Rebranded the integration domain to
- 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 canonicalvidaa.*actions. - Clean Up Alerts: Includes a friendly Home Assistant Repairs notification to help you safely delete the obsolete
hisense_vidaafolder 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)orHDMI 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.
- Friendly Input Names: Your TV now automatically discovers and shows friendly names for connected HDMI devices (e.g.,
- 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_outputattribute on your TV (TV SpeakersorARC / eARC), retiring clunky standalone select entities.
- Audio output is now cleanly reported as an
- 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.
- Added smart detection for the VIDAA Home screen (
- 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.
- Consolidated diagnostic sensors into a single, clean Session Status sensor (
- REMOTE KEYBOARD & TEXT INPUT:
- Added virtual text typing to
remote.send_commandusing thetext:<string>prefix, making on-screen searches and typing fast from automations and scripts.
- Added virtual text typing to
- 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
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
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:
🌟 What's New & Fixed in v3.3.1
- WAKE-ON-LAN BROADCAST DISPATCH (#52):
- Keyword Argument Preservation: Switched executor dispatch in
tv/actions.pyto usefunctools.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:9and subnet-directed<subnet>.255:9alongside direct unicast, resolving power-on failures from deep standby across subnets and UDP relays (verified on Hisense PX3-Pro).
- Keyword Argument Preservation: Switched executor dispatch in
- STANDBY & SIGNAL GUARDING (#53):
- Guarded
KEY_POWERtoggling and active signal detection during TV fake sleep/standby transitions.
- Guarded
- 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_implementederror dialog when adding or reconfiguring TVs in the UI.
- Reordered class inheritance in
- 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.mdand created localized README guides indocs/i18n/for German, Italian, French, Russian, Ukrainian, and Simplified Chinese.
- Added complete 100% key-parity translations for Russian (
- 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 rootscripts/to ensure they are excluded from HACS production zip releases. - Hardened unit tests and CI workflow with hermetic mocks and
voluptuousinstallation across Python 3.12 and 3.13.
- Relocated CLI utilities (
v3.3.1-beta.1
🧪 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 standard255.255.255.255:9and subnet-directed<subnet>.255:9. - Fixes power-on failures from deep standby across subnets / UDP relay environments.
- Resolved argument passing in the executor call (
- Standby & Power State Guarding (#53):
- Guarded
KEY_POWERtoggling and active signal state detection during TV fake sleep/standby transitions.
- Guarded
- 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.
- Corrected class inheritance order in
- 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.
- Remote next/previous track controls intelligently map to Live TV channel navigation (
- On-Screen Notifications (#54):
- Added support for sending toast messages directly to VIDAA TV screens via the
notifyentity.
- Added support for sending toast messages directly to VIDAA TV screens via the
🌐 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).
- Added complete 100% key-parity translations for Russian (
- 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.
- Added dark-mode friendly SVG language switcher badges in
🛠️ Developer Tooling & Packaging
- Clean Repository Structure: Moved standalone developer testing tools (
test_client.py,debug_tv.py) into rootscripts/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
- In Home Assistant, open HACS → Integrations → Hisense VIDAA TV.
- Click the three dots menu (⋮) in the top right corner and enable "Show beta".
- Click Redownload, select v3.3.1-beta.1, click Download, and restart Home Assistant.
v3.2.0
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:
🌟 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 omittedbrand=. - 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 onHisenseTvClient, persisting the new credentials cleanly toentry.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 withrc: 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): Addeddetect_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): AddedCONF_BRANDselector 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): Updatednormalize_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): Supportedmacandnetwork_deviceas fallback MAC keys in UPnP XML descriptors alongsidemacWifi. - 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
--brandparameter totest_client.pyanddebug_tv.pywith open brand support.
- Full cryptographic and lifecycle support for all licensed partner TV brands running VIDAA OS: Hisense (
- 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
tpoandtoptroacrossBRAND_OPTIONS,BRAND_MAP, andBRAND_CODE_MAP. - Expanded the pairing cascade fallback candidate list to automatically probe
tpoalongsidetos,loe,tpv,shp, andjvcwhen initial connections to projector brokers fail. - Enhanced
async_probe_tv_auth_methods()andHisenseTvClient.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) usingAUTH_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.brandfrom UPnP descriptor fingerprints before pairing ifclient.brandis still at default ("his"), safeguarding manual brand overrides.
- Added official OEM brand support for TOPTRO portable smart projectors running VIDAA OS (e.g. FreeStyle series), mapping
- "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_profileand 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).
- Added
- 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.
- Implemented strict PEM certificate and private key validation via
- 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(), andresolve_ca_certificate()inasync_setup_entryto Home Assistant's threadpool executor viahass.async_add_executor_job(). - Hardened
HisenseTvClient.__init__to skip disk certificate scans and resolution entirely whenuse_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 inextract_pkcs12_to_pem()to reuse existing extracted PEM certificate and key files on subsequent startups without re-reading the.p12archive, 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.
- Resolves GitHub issue #49 (
- ASYNC UPnP
<modelDescription>CAPABILITY EXTRACTION (protocol/upnp.py):- Enhanced
HisenseUpnpClient.async_get_device_fingerprint()to parse<modelDescription>as key-value pairs, extractingbrand,platform,vidaa_support,voice,transport_protocol,mac_wifi, andmac_ethernetasynchronously.
- Enhanced
- 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.
- Enriched
- TEST SUITE MODULARIZATION & EXPANSION (262 PASSING TESTS):
- Decoupled oversized test suites into modular, single-responsibility modules:
- Split
test_client_auth.pyintotest_client_tokens.py(token lifecycle/drift/standby),test_client_reconnect.py(reconnect locks/backoff/rejection thresholds), andtest_client_auth.py(core auth profiles/probing). - Split
test_pairing.pyintotest_pairing_guards.py(abort flow/duplicate guards),test_pairing_cascade.py(brand fallback cascade/profile fallback), andtest_pairing.py(PIN challenge probing/flows). - Split
test_services.pyintotest_services_targeting.py(device/area/floor/label resolution & guards) andtest_services.py(service executions). - Added
test_multi_brand_readiness.pycovering OEM brand select...
- Split
- Decoupled oversized test suites into modular, single-responsibility modules:
v3.1.0
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:
🌟 What's New & Hardened in v3.1.0
- NATIVE
aiomqtt>=2.3.0ASYNC TRANSPORT ENGINE (async-dependency: done):- Replaced legacy threaded
paho-mqtt(loop_start()/loop_stop(),threading.Timer,threading.Lock,threading.Thread, and cross-threadhass.loop.call_soon_threadsafe) with nativeaiomqtt.Clientasync context managers running directly on Home Assistant's event loop. - Replaced synchronous locks and thread sleeps with
asyncio.Task,asyncio.Lock, andasyncio.Futurequery routing for snappy, non-blocking TV state requests and commands. - Eliminated unnecessary
hass.async_add_executor_jobinvocations across all platforms (media_player,remote,button,switch,select,number,notify,services).
- Replaced legacy threaded
- SHARED
aiohttp.ClientSessionWEBSESSION INJECTION (inject-websession: done):- Injected Home Assistant's shared
aiohttp.ClientSessionviaasync_get_clientsession(hass)intoHisenseTvClientandHisenseUpnpClient. - Added non-blocking async UPnP HTTP
Dateheader synchronization (async_get_tv_timestamp) and device fingerprinting (async_get_device_fingerprint), replacing legacyurllib.request.urlopen.
- Injected Home Assistant's shared
- LOVELACE REMOTE EXAMPLES & DARK MODE MODERNIZATION (
examples/):- Optimized
examples/lovelace-australian-remote-card.yamlandexamples/lovelace-us-remote-card.yamlfor Home Assistant dark mode and browser rendering engines. - Added
keepconfig (background: true,box_shadow: true,border_radius: true) tocustom:stack-in-cardto eliminate seam artifacts between card segments. - Protected buttons against Chrome/Blink auto-dark-mode contrast inversion with
forced-color-adjust: noneandcolor-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.
- Optimized
- STANDARDIZED ENTITY IDS ACROSS EXAMPLES & AUTOMATION DOCS (
examples/,docs/):- Standardized entity IDs to
living_room_hisense_vidaa_tvacross all 6 Lovelace card examples (australian-remote,us-remote,classic-remote,button-card-remote,android-tv-card,tv-card) and throughoutdocs/services_and_automations.md.
- Standardized entity IDs to
- 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) instrings.jsonand translation catalogs.
- Safeguarded custom services (
- 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
RuntimeWarningmessages in test harnesses and standalone scripts.
- Closed unspawned coroutines cleanly when the event loop is absent to eliminate Python
- 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.jsonat"quality_scale": "bronze"in accordance with Home Assistant Core staged review policy.
- Formally achieved 100% rule compliance across all 54 Bronze, Silver, Gold, and Platinum rules in
- 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
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:
🌟 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_infoinHisenseVidaaEntityto live telemetry attributes (model_name,manufacturer,firmware_version), falling back to config entry values. - Implemented real-time
async_update_devicecallback on incominggetdeviceinfoandgettvinfoMQTT telemetry, with clean unload unregistration. - Updated device registry lookup to use modern
async_get_device_by_identifierwith backwards-compatible fallback, preventing deprecation warnings in HA 2025.1+.
- Sanitized generic UPnP
- DYNAMIC MDI APP & SOURCE ICON BRANDING (
media_player.py):- Added dynamic
iconproperty toHisenseVidaaMediaPlayerresolving 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.
- Added dynamic
- 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.
- Parameterized the brand identifier across pairing handshake, dynamic username generation, client ID formatting, and password hashing (
- INTEGRATION QUALITY SCALE (GOLD TIER) HARDENING & EXPANDED DOCUMENTATION:
- Implemented
async_remove_config_entry_devicein__init__.pyfor stale device cleanup (stale-devices). - Added formal tracking file
quality_scale.yamldocumenting adherence across Bronze, Silver, and Gold IQS rules. - Pinned
manifest.jsonto 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), anddocs/services_and_automations.md(real-world automation recipes for cinema mode, gaming mode sync, doorbell toast alerts, and late-night audio guard).
- Implemented
- 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
- MASK SENSITIVE MQTT TOKENS IN DEBUG LOGS (
protocol/dispatcher.py,protocol/auth.py,protocol/pairing.py):- Implemented
mask_sensitive_payloadandmask_sensitive_datato ensureaccesstoken,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_messageon 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_refreshstandalone refresh client (on_token_message). - Masked PIN response payloads and exception error strings in
protocol/pairing.py.
- Implemented
- HOME ASSISTANT DIAGNOSTICS WIRE-KEY REDACTION (
diagnostics.py):- Added wire-format payload keys
"accesstoken"and"refreshtoken"toTO_REDACTindiagnostics.pyto ensure diagnostics downloads redact tokens across all key naming variations.
- Added wire-format payload keys
- 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.
- Masked stdout token printing in
- AUTOMATED SENSITIVE DATA LOGGING TEST SUITE (
tests/test_dispatcher.py,tests/test_diagnostics.py):- Added comprehensive unit tests with
pytestcaplogfixture verifying that debug logs never leak raw access or refresh tokens across dispatch, refresh, and diagnostics platforms, expanding test suite to 215 tests.
- Added comprehensive unit tests with