Guide de démarrage rapide pour débutants

Associez votre téléviseur ou projecteur VIDAA à Home Assistant en moins de 3 minutes sans ligne de commande.

Architecture universelle pour TOUTES les marques VIDAA

Que votre téléviseur ou projecteur soit de marque Hisense, Toshiba, Loewe, Philips, Sharp, JVC ou TOPTRO, s'il fonctionne sous VIDAA OS, cette configuration s'applique à l'identique. Tous les appareils VIDAA OS partagent le même courtier MQTT interne sur le port 36669.

Bienvenue ! Ce guide est conçu pour les débutants. Il élimine les lignes de commande complexes et les conversions OpenSSL pour associer votre téléviseur à Accueil Assistant en moins de 3 minutes.

📋 Ce dont vous aurez besoin

  • Un ordinateur avec navigateur web (Windows, macOS ou Linux) (Windows, macOS, or Linux).
  • Un accès aux fichiers de Accueil Assistant (via File Editor, Studio Code Server ou partage réseau Samba) (via the File Editor add-on, Studio Code Server, or a Samba / Windows Network Share).
  • Votre téléviseur allumé et connecté au même réseau local que Accueil Assistant (same Wi-Fi or wired network as Accueil Assistant).
Aucun smartphone, tablette ou émulateur Android requis !

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️⃣ Étape 1 : Télécharger et extraire la clé de certificat

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. Copier 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. Copier client_mobile_android.p12 (or El.p12 / 3R.p12) to your desktop.

🐧 Linux / Accueil Assistant Terminal

Run a single command to extract directly into your Accueil 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️⃣ Étape 2 : Déposer la clé dans Accueil Assistant (`/config/ssl/`)

Copier your extracted .p12 file into Accueil Assistant's /config/ssl/ folder:

  • File Editor Add-on: Open File Editor in Accueil 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.
Aucune conversion de certificat requise

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️⃣ Étape 3 : Ajouter l'intégration et saisir le code PIN à 4 chiffres

  1. Restart Accueil 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 Accueil Assistant and click Submit.
Prérequis critique : Le code PIN n'apparaît pas à l'écran ?

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 bloque le popup PIN si les services connectés sont désactivés. (Conseil confidentialité : Une fois l'association terminée, vous pouvez bloquer l'accès internet de la TV sur votre routeur ; le contrôle local fonctionne 100% hors ligne).

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

⚡ Prochaines étapes & bonnes pratiques