Your LG TV.
Right at home.

Before you start: Home Assistant OS on aarch64 or amd64, an administrator account, a compatible TV, and HACS installed and configured. Keep the TV, Home Assistant and dashboard device on a network where they can reach each other. Container/Core installations have no app store for this guide.

1. Install the Bridge.

   The connection between Home Assistant and your TV.

   1. Open Settings → Apps → Install app → ⋮ → Repositories. Add the repository URL above. Older versions call Apps “Add-ons”.
   2. Find LG webOS Remote Bridge and select Install. Open its Configuration tab, fill in these fields, and save.

   Bridge configurationCopy YAML

   tv_ip: "YOUR_TV_IP"
   mac_address: "YOUR_TV_NETWORK_MAC"
   listen_port: 8788
   broadcast_address: "255.255.255.255"
   auth_token: "YOUR_RANDOM_TOKEN"

   Find the TV IP and the active Wi-Fi or Ethernet MAC in the TV’s network settings or router. Use a new random token of at least 40 characters, not a Home Assistant API token. Keep it private.

   How do I generate the token?

   Run this on a computer with Python. Copy the result privately into the Bridge and card configuration; do not paste it into a chat or screenshot.

   Run locallyCopy command

   python3 -c 'import secrets; print(secrets.token_urlsafe(32))'

   Turn on your TV, Start the Bridge, and approve the pairing prompt on the TV. Enable Start on boot in the app’s Info tab.

   Check the log: “LG webOS Remote listening on port 8788” means the Bridge is running. “TV paired/connected” confirms the TV connection.

   Official Home Assistant repository instructions

2. Install the card.

   The remote you’ll add to your dashboard.

   1. Open HACS → ⋮ → Custom repositories. Add the same repository URL and choose Dashboard as the category.
   2. Find LG webOS Remote for Home Assistant. Select Download, choose v1.0.1, and confirm.
   3. Reload your browser when prompted so it loads the new card.

   If the card resource wasn’t added automatically

   Open Settings → Dashboards → Resources and add the URL below as a JavaScript module, once. If Resources is hidden, enable Advanced mode in your user profile. YAML-managed dashboards register this URL with type: module in their resource configuration.

   Card resource URLCopy URL

   /hacsfiles/ha-webos-remote/ha-webos-remote.js

   This is a custom repository, not a default HACS catalog listing. Official HACS instructions

3. Add your remote.

   Connect the card to the Bridge and check it works.

   Open your dashboard and select Edit → Add card → Manual. Paste the YAML below, replace the placeholders, and save.

   Dashboard card YAMLCopy YAML

   type: custom:lg-webos-remote
   name: Living Room TV
   url: ws://YOUR_HOME_ASSISTANT_IP:8788
   token: "YOUR_RANDOM_TOKEN"
   sensitivity: 1
   scrollSensitivity: 1

   Use the Home Assistant IP in the card URL, not the TV IP. The token must exactly match the Bridge’s auth_token. Don’t add the dashboard path or port 8123. “Visual editor not supported” is expected.

   Try it: with the TV on, look for “TV On”. Test Home and volume, then move and click the pointer in the TV browser. Test power-off and Wake-on-LAN separately.

   Using an HTTPS dashboard? Use a trusted wss:// proxy route. Browsers may block plain ws:// from an HTTPS page. Connection and security notes

Help me install LG webOS Remote for Home Assistant:
https://github.com/sonim1/ha-webos-remote

Read the current README, docs/COMPATIBILITY.md, docs/UPDATING.md and SECURITY.md first. Use the stable release.

Inspect my Home Assistant installation, CPU architecture, HACS, existing Bridge/card installs and HTTP/HTTPS access. This app guide requires Home Assistant OS on aarch64 or amd64.

Install BOTH the LG webOS Remote Bridge app and the HACS Dashboard card using the repository above. Ask only for missing setup information. Have me turn on the TV and approve pairing.

Generate a random Bridge auth_token locally with at least 40 characters. Configure the TV IP and active interface MAC in the Bridge. Use the Home Assistant host and Bridge port 8788 in the card, with the same token. For HTTPS, use a trusted WSS route.

Preserve settings and pairing data. Back up before replacing an install; ask before removing any existing Bridge or changing shared network settings. Never expose tokens, pairing keys or private device details in chat, screenshots or commits. Do not expose the Bridge to the internet or run competing Bridges.

Verify card connection, Home, volume, full-screen pointer movement, power-off and Wake-on-LAN separately. Report observed, failed and untested results honestly. If you lack access, give me exact UI steps instead of claiming completion.