Beginner's Quick Start Guide
Pair your VIDAA Smart TV or projector with Home Assistant in under 3 minutes with zero command-line tools.
Whether your TV or smart projector is branded as Hisense, Toshiba, Loewe, Philips, Sharp, JVC, or TOPTRO, if it runs VIDAA OS, this exact same setup applies. All VIDAA OS devices share the internal hardware MQTT broker on port 36669 and authenticate using the universal client certificate.
Welcome! This guide is designed for first-time users and beginners. It skips confusing command-line steps and OpenSSL conversions so you can get your smart TV or projector paired and running in Home Assistant in less than 3 minutes.
📋 What You Will Need
- A computer with a web browser (Windows, macOS, or Linux).
- Access to your Home Assistant files (via the File Editor add-on, Studio Code Server, or a Samba / Windows Network Share).
- Your TV powered on and connected to your local network (same Wi-Fi or wired network as Home Assistant).
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️⃣ Step 1: Download & Extract the Certificate Key
Follow these quick steps on your laptop or desktop computer:
- 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.).
- Download the free
.apkfile to your computer. - 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. Copy 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. Copy 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:
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️⃣ Step 2: Place the Key in Home Assistant (`/config/ssl/`)
Copy 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.p12file. - 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
ssldirectory in the left file tree.
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️⃣ Step 3: Add the Integration & Enter 4-Digit Screen PIN
- Restart Home Assistant: Go to Settings → System and click Restart (top right).
- Add the Integration:
- Go to Settings → Devices & Services.
- Click + Add Integration in the bottom right corner.
- Search for VIDAA Smart TV and click it.
- 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.
- Enter your TV's local IP address (e.g.
- 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.
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 suppresses the on-screen pairing PIN popup if Connected Services are toggled off. (Privacy Tip: Once pairing is complete, you can safely block the TV from internet/WAN access at your router firewall—local Home Assistant control operates 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.
⚡ Next Steps & Best Practices
⚙️ Configuration & Options
Configure tabbed options: General & Power, Sources & Media, Remote Key Delays, and Brand Profiles.
🌐 Network & Standby Setup
Set up static DHCP reservations, reliable Wake-on-LAN, and isolated IoT VLAN firewall rules.
🛠️ Automations & Remote Cards
Copy ready-to-use YAML automations for movie modes and build the Australian 12-app Lovelace remote card.