Guía de inicio rápido para principiantes

Vincule su Smart TV o proyector VIDAA con Home Assistant en menos de 3 minutos sin comandos.

Arquitectura universal en TODAS las marcas VIDAA

Ya sea que su televisor o proyector sea de marca Hisense, Toshiba, Loewe, Philips, Sharp, JVC o TOPTRO, si funciona con VIDAA OS, se aplica exactamente esta misma configuración. Todos los dispositivos VIDAA OS comparten el broker MQTT interno en el puerto 36669 y usan el mismo certificado cliente.

¡Bienvenido! Esta guía está diseñada para principiantes. Omite comandos de terminal y conversiones OpenSSL para que pueda vincular su Smart TV o proyector en Inicio Assistant en menos de 3 minutos.

📋 Lo que necesitará

  • Un ordenador con navegador web (Windows, macOS o Linux) (Windows, macOS, or Linux).
  • Acceso a los archivos de Inicio Assistant (vía File Editor, Studio Code Server o carpeta compartida Samba) (via the File Editor add-on, Studio Code Server, or a Samba / Windows Network Share).
  • Su televisor encendido y conectado a la misma red local que Inicio Assistant (same Wi-Fi or wired network as Inicio Assistant).
¡No se requiere teléfono, tableta ni emulador Android!

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️⃣ Paso 1: Descargar y extraer la clave de certificado

Siga estos pasos en su ordenador:

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

🐧 Linux / Inicio Assistant Terminal

Run a single command to extract directly into your Inicio 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️⃣ Paso 2: Colocar el archivo en Inicio Assistant (`/config/ssl/`)

Copiar your extracted .p12 file into Inicio Assistant's /config/ssl/ folder:

  • File Editor Add-on: Open File Editor in Inicio 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.
Sin necesidad de convertir certificados

La integración VIDAA procesa archivos PKCS#12 (.p12) directamente con criptografía Python nativa. No necesita convertir a .pem ni extraer claves privadas.

3️⃣ Paso 3: Añadir la integración e ingresar el PIN de 4 dígitos

  1. Restart Inicio 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 Inicio Assistant and click Submit.
Requisito crítico: ¿El PIN no aparece en la pantalla?

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 bloquea la ventana de PIN si los servicios conectados están desactivados. (Consejo de privacidad: Una vez emparejado, puede bloquear el acceso a internet de la TV en su router; el control en Inicio Assistant funciona 100% offline).

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

⚡ Próximos pasos y mejores prácticas