Panasonic Viera smart home integration, free and open source
Panasonic Viera TVs on the local network: power, volume, mute, keys, source, apps.
Published by LM1LC3N7
- Devices
- Version 0.1.2
- Requires Gladys >=5.1.0
- ★ 0
Control your Panasonic Viera TVs from Gladys, on your local network, without any cloud: power, volume, mute, remote keys, source (TV, HDMI 1 to 4) and application launch. The integration uses the UPnP/SOAP network remote control of the TV (port 55000), the one Panasonic's "TV Remote" app uses.
Unofficial integration, not affiliated with Panasonic. This first milestone was written and tested against a simulated TV: it has never been tested on a real TV. Your feedback is welcome.
Prepare the TV
- In the TV menus: Network > TV Remote App Settings (the name varies with the year), enable TV Remote (network remote control).
- To turn the TV on from Gladys, also enable, depending on the model, Powered On by Apps and/or Wake-on-LAN.
- Give the TV a fixed IP address in your router (reserved DHCP lease).
Add a TV
- By its address: type the IP address in "IP addresses of the TVs" (several addresses separated by commas) and save.
- By the search: use Find the TVs. Gladys searches the network (SSDP) for the integration; a TV that is off, or a network blocking multicast, may not answer: type the address then.
The TV appears in the integration's Discovery tab: create it.
Pairing (models from about 2018 on)
Recent TVs (FZ, GZ, HZ, JZ series and later) encrypt their remote control and ask for a PIN once:
- Turn the TV on.
- In the integration configuration, use Start pairing with the TV's IP address. The TV shows a PIN (4 to 8 digits, usually 4).
- Within 5 minutes, use Finish pairing with that PIN.
The integration then keeps the keys given by the TV in its own data folder
(/data); they are never sent to Gladys nor written to the logs. They stay
there when the device is deleted from Gladys (a "forget a TV" action is
planned). If the TV is reset and explicitly refuses these keys (or refuses the
session three times, minutes apart, while on), the integration status says
so: pair again. The keys are still tried again every 30 minutes, in case the
refusal was passing. Older TVs need no pairing.
Before pairing, volume and mute already work; keys, power and applications do not.
What you get
| Feature | Detail |
|---|---|
| Power | State read from the TV; command with the power key |
| Volume | 0 to 100, read and set |
| Mute | Button: each press toggles the mute read from the TV |
| Buttons | Volume +/-, channel +/-, last view, arrows, OK, back, exit, menu, option, info, guide, input, play, pause, stop, rewind, fast forward, skip back/forward, record |
| Source | Dropdown: TV, HDMI 1 to 4 |
| Application | Dropdown: Netflix, YouTube, Prime Video, web browser… and the applications the TV lists (after an "Update" of the device in Discovery) |
| Remote key | Dropdown of every remote key (digits, colours, subtitles…), handy in scenes |
Source and application are not read back from the TV: the dropdowns command, they do not show the state.
Turning the TV on
The power key toggles: the integration reads the state from the TV just before acting (1.5 s at most) and sends nothing when the TV already is in the wanted state. "On" means "the TV answers volume requests"; "off" means "nothing answers": the connection is refused or never accepted. When the TV answers something unexpected, or accepts the connection and then says nothing, the state is unknown: nothing is published (Gladys keeps showing the last known state) and no power key is sent.
- TV in network standby ("Powered On by Apps" enabled): the power key is enough.
- TV in deep standby (it answers nothing at all): Wake-on-LAN is
needed. Gladys sends the packet for the integration, to the MAC seen by the
search, or the one typed in "MAC addresses for Wake-on-LAN"
(
192.168.1.40=a8:13:74:12:34:56). With a known MAC, "turn on" always sends the packet; if the TV still answers on its network port, the power key is sent first. The command is confirmed to Gladys at once, then the integration waits up to 20 seconds for the TV in the background, sending the packet again every 2.5 seconds, never a power key (it could turn off a TV that is booting). If a TV does not wake up, try the broadcast address of your network in "Wake-on-LAN broadcast address".
Known limits, in both directions (to be checked on real models):
- a TV in standby that still answers volume requests shows as on: "turn on" then sends nothing (but Wake-on-LAN, when the MAC is known);
- a TV that is on but does not answer volume requests shows as off: "turn on" would then send the power key and turn it off.
Workaround in both cases: the "Remote key" dropdown, value Power, sends the power key as is, without reading the state.
Settings
- Refresh interval: how often power, volume and mute are read, 5 to 300 seconds (10 by default).
- Check the TVs: state, pairing and Wake-on-LAN of every known TV.
Limits
- Local network only, port 55000 open between Gladys and the TV.
- Gladys voice notifications do not go through the TV.
- The direct HDMI keys and the application list depend on the model.
- Never tested on a real TV so far.
Credits
Logic ported to JavaScript from panasonic-viera by Florian Holzapfel (MIT license). Panasonic and Viera are trademarks of Panasonic Holdings Corporation, used only to name the compatible products.
Configuration settings
These are the settings Panasonic Viera asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| Your Panasonic Viera TVs, on your local network | section | No | Power, volume, mute, remote keys, source and applications, through the UPnP/SOAP remote control of the TV (port 55000), without any cloud. On the TV, allow the network remote control (Network > TV Remote App Settings). Give each TV a fixed IP address in your router, then type the addresses below, or use "Find the TVs". The TVs then appear in the Discovery tab. Models from 2018 on ask for a pairing: see the Pairing section. Unofficial integration, not affiliated with Panasonic. |
| IP addresses of the TVs | string | No | Separated by commas, for example 192.168.1.40, 192.168.1.41. TVs found by the search are kept without being typed here. |
| MAC addresses for Wake-on-LAN (optional) | string | No | To turn on a TV in deep standby: IP=MAC pairs separated by commas, for example 192.168.1.40=a8:13:74:12:34:56. The search fills the MAC in by itself when Gladys sees it. Wake-on-LAN must be enabled in the TV's network settings. |
| Wake-on-LAN broadcast address (optional) | string | No | Only if a TV does not wake up: the broadcast address of your network, for example 192.168.1.255. Empty: 255.255.255.255. |
| Refresh interval (s) | number | No | How often power, volume and mute are read, in seconds. |
| Pairing (models from 2018 on) | section | No | Recent TVs encrypt their remote control and ask for a PIN once. Turn the TV on, press "Start pairing" with its IP address: the TV shows a PIN (4 to 8 digits). Type it in "Finish pairing" within 5 minutes. The keys the TV gives are kept by the integration only, in its data folder (they stay there after a device is deleted). Older TVs need no pairing. Volume and mute work even before pairing. |
How to install Panasonic Viera in Gladys
- In Gladys, open Integrations: Panasonic Viera appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/lm1lc3n7/gladys-panasonic-viera:0.1.2), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration). - Open the Configuration screen of the integration, fill in the settings, and save.
- You can also install it directly from its repository URL: https://github.com/LM1LC3N7/gladys-panasonic-viera.
Panasonic Viera requires Gladys >=5.1.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.
Not running Gladys yet? It is free and open source: follow the installation guide to get started.
About external integrations
Panasonic Viera is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by LM1LC3N7, not by the Gladys core team.
- Browse all integrations, native and community
- Build and publish your own external integration
- Source code on GitHub — source of this documentation