Guida rapida introduttiva per principianti

Abbina la tua Smart TV o proiettore VIDAA a Home Assistant in meno di 3 minuti senza terminale.

Architettura universale per TUTTI i marchi VIDAA

Che la tua TV o proiettore sia a marchio Hisense, Toshiba, Loewe, Philips, Sharp, JVC o TOPTRO, se utilizza VIDAA OS, questa identica procedura è valida. Tutti i dispositivi VIDAA OS condividono lo stesso broker MQTT hardware sulla porta 36669.

Benvenuto! Questa guida è pensata per i principianti. Evita comandi da terminale e conversioni OpenSSL per abbinare la tua Smart TV a Home Assistant in meno di 3 minuti.

📋 Cosa ti servirà

  • Un computer con browser web (Windows, macOS o Linux) (Windows, macOS, or Linux).
  • Accesso ai file di Home Assistant (tramite componente File Editor, Studio Code Server o condivisione Samba) (via the File Editor add-on, Studio Code Server, or a Samba / Windows Network Share).
  • La tua TV accesa e connessa alla stessa rete locale di Home Assistant (same Wi-Fi or wired network as Home Assistant).
Nessun telefono, tablet o emulatore Android richiesto!

We download the free public mobile app package only because Hisense / VIDAA bundles the mutual TLS communication key inside it. An .apk file is simply a standard .zip archive. You can rename and unzip it on any PC or Mac with zero terminal knowledge.

1️⃣ Passaggio 1: Scaricare ed estrarre la chiave del certificato

Follow these quick steps on your laptop or desktop computer:

  1. Open your browser and search for the free official app on a public APK mirror (such as APKMirror - VIDAA Smart TV by VIDAA USA, Inc.).
  2. Download the free .apk file to your computer.
  3. Extract the key file depending on your operating system:

🪟 Windows

1. Right-click the downloaded .apk file and rename the extension to .zip (e.g. app.apk → app.zip).
2. Double-click app.zip to open it.
3. Navigate into the res/raw folder (or res/).
4. Copia client_mobile_android.p12 (or El.p12 / 3R.p12) to your desktop.

🍏 macOS

1. Right-click the .apk file → Rename → change ending to .zip.
2. Double-click to unzip the archive.
3. Open the unzipped folder → res/raw (or res/).
4. Copia client_mobile_android.p12 (or El.p12 / 3R.p12) to your desktop.

🐧 Linux / Home Assistant Terminal

Run a single command to extract directly into your Home Assistant SSL folder:

BASH
unzip -j app.apk res/raw/client_mobile_android.p12 -d /config/ssl/
# Or if obfuscated in alternative builds:
unzip -j app.apk res/El.p12 -d /config/ssl/

Note: Whether your APK names the file client_mobile_android.p12, El.p12, or 3R.p12, they contain the exact same mutual TLS client certificate and private key.

2️⃣ Passaggio 2: Inserire la chiave in Home Assistant (`/config/ssl/`)

Copia your extracted .p12 file into Home Assistant's /config/ssl/ folder:

  • File Editor Add-on: Open File Editor in Home Assistant → click folder icon → navigate to ssl/ (create the folder if it does not exist) → click Upload File (cloud icon) and select your .p12 file.
  • Samba / Windows Network Share: Open your network share (\\homeassistant\config\ssl) and paste the file inside.
  • Studio Code Server: Drag-and-drop the file directly into the ssl directory in the left file tree.
Nessuna conversione di certificato necessaria

The VIDAA integration natively parses PKCS#12 (.p12) bundles on the fly using native Python cryptography. You do not need to convert to .pem, extract private keys, or set encryption passwords.

3️⃣ Passaggio 3: Aggiungere l'integrazione e inserire il PIN a 4 cifre

  1. Restart Home Assistant: Go to Settings → System and click Restart (top right).
  2. Add the Integration:
    • Go to Settings → Devices & Services.
    • Click + Add Integration in the bottom right corner.
    • Search for VIDAA Smart TV and click it.
  3. Connect to TV:
    • Enter your TV's local IP address (e.g. 192.168.1.50).
    • Leave Auth Profile and Brand set to Auto Detect (Recommended).
    • Click Submit.
  4. Type the 4-Digit Screen PIN:
    • Look at your TV screen—a clean 4-digit PIN dialog will appear!
    • Type the 4 numbers into the prompt in Home Assistant and click Submit.
Prerequisito critico: Il PIN non appare sullo schermo?

If the PIN code dialog does not appear on your TV screen, check your TV menu to ensure Connected / Smart Services and the vendor Terms & Conditions are accepted:

Settings → Support / System → Terms & Conditions / Smart Services → Accept All

VIDAA OS blocca la comparsa del PIN se i servizi connessi sono disattivati. (Suggerimento privacy: Una volta completato l'abbinamento, puoi bloccare l'accesso a Internet della TV sul router; il controllo in Home Assistant funziona al 100% offline).

🎉 Pairing Complete! Your TV is now added to Home Assistant with full media player controls, volume stepping, app launching, Wake-on-LAN, and remote key navigation.

⚡ Passaggi successivi e migliori pratiche