A Panasonic Viera Smart-TV adapter for ioBroker
This is an ioBroker adapter for your Panasonic Viera Smart-TV.
Setup and pairing
1. Prepare the TV
- Switch the TV on.
- Open
Menu -> Network -> TV Remote App Settingsand switch all of these ON:- TV Remote
- Powered On by Apps
- Networked Standby
- Open
Menu -> Network -> Network Status -> Status Detailsand note the IP address of the TV. Best give the TV a fixed IP address in your router, so it does not change later.
2. Find out whether your TV needs pairing
- Older TVs (roughly before 2019) talk to the adapter unencrypted. They need no pairing: enter only the IP address and leave Application ID and Encryption Key empty.
- Newer TVs only accept encrypted commands. They need an Application ID and an Encryption Key, which the adapter gets once by pairing with a PIN shown on the TV (step 4).
If you are not sure, try without pairing first: enter only the IP address, save, and press a key in the Remote control tab. If the TV reacts, you are done. If not, pair it.
3. Enter the IP address
- Make sure the
panasonic-vierainstance is running (it may still show "Please configure" in the log - that is fine). The search for TVs and the pairing are done by the running instance. - Open the settings of the instance.
- IP: click into the field. TVs found in your network are offered for selection. Otherwise type the IP address.
4. Pair the TV (newer TVs only)
All in the Settings tab, section Pairing (newer TVs only):
- Switch the TV on (not standby).
- Press Show PIN on the TV. The TV shows a 4-digit PIN for the remote "ioBroker".
- Type the PIN into PIN shown on the TV.
- Press Pair. Application ID and Encryption Key are filled in.
- Save the settings. The instance restarts and talks to the TV encrypted from now on.
The PIN itself is not saved, only the Application ID and the Encryption Key.
If it does not work:
- No PIN appears or the message says the TV does not answer: the TV must be on (not in standby), TV Remote must be switched on (step 1) and the IP address must be the one of the TV.
- Invalid PIN code: it was typed wrong. Type it again and press Pair. If the PIN disappeared from the TV, press Show PIN on the TV again - the TV shows a new PIN.
- "Please let the TV show a PIN first": press Show PIN on the TV first. Also after a restart of the instance or after more than 5 minutes a new PIN is needed.
- An error right after "Show PIN on the TV" on an older TV: older TVs do not support pairing - they need none (step 2).
5. Check that it works
panasonic-viera.0.info.connection becomes true while the TV answers, and the Remote control tab of the
settings controls the TV.
If the TV stops reacting after a firmware update or a factory reset, pair it again (step 4).
Channel tv (type-detector)
In addition to the existing objects the adapter creates the channel panasonic-viera.0.tv, which the ioBroker
type-detector (>= 6.2.0) recognizes as device type tv. Visualizations and the devices adapter can control the TV
with it:
| State | Role | Description |
|---|---|---|
tv.power | switch.power | on / off (the TV has only a toggle key, it is sent only if needed) |
tv.key | media.key | a key: UP, DOWN, SELECT, BACK, HOME, NUMBER_1, RED, ... |
tv.volume | level.volume | volume 0-100 |
tv.muted | media.mute | mute |
tv.volumeUp | button.volume.up | volume up |
tv.volumeDown | button.volume.down | volume down |
tv.input | media.input | TV, HDMI1 ... HDMI4 |
tv.app | media.app | start an app: YOUTUBE, NETFLIX, PRIME_VIDEO, BROWSER, ... |
tv.unreach | indicator.maintenance.unreach | the TV does not answer the ping |
tv.app offers YouTube, Netflix, Prime Video and Browser first. As soon as the TV is on, the adapter reads the
apps installed on the TV and offers those of them that the type-detector knows. The Remote control tab has
buttons for the same apps.
Switching the TV on via the network requires Networked Standby and Powered On by Apps on the TV.
Changelog
2.2.0 (2026-10-29)
- (bluefox) The adapter was refactored to TypeScript and JsonConfig
- (bluefox) Fixed the buttons basic.VOLUP, basic.VOLDOWN and basic.LEFT, they sent an invalid key
- (bluefox) The adapter no longer restarts when the TV answers the ping but not the mute request
- (bluefox) The IP field offers the TVs found in the network
- (bluefox) Newer (encrypted) TVs can be paired with a PIN directly in the settings
- (bluefox) Added a remote control to the instance settings (tab "Remote control", requires admin 8)
- (bluefox) Added the channel
tvfor the device typetvof the type-detector, so visualizations and the devices adapter can control the TV - (bluefox) Apps like YouTube and Netflix can be started (
tv.appand buttons in the remote control) - (copilot) Adapter requires node.js >= 22 now
- (iobroker-bot) Adapter requires node.js >= 20 now.
- (copilot) Adapter requires admin >= 7.7.22 now
- (copilot) Adapter requires js-controller >= 6.0.11 now
- (copilot) Adapter requires admin >= 7.6.17 now
- (copilot) CI/CD: Updated GitHub Copilot instructions template to v0.5.7
2.1.0 (2024-04-25)
- (mcm1957) Adapter requires node.js >= 18 and js-controller >= 5 now
- (mcm1957) Dependencies have been updated
2.0.0 (2021-05-09)
- (jens-maus) added support to set Application and Encryption Key in adapter admin
- (jens-maus) changed adapter to use node-panasonic-viera to support modern TV models
1.0.2
- (cyberindy) some fixes
1.0.1
- (ldittmar) compact mode compatibility added
- (ldittmar) add chinese support
License
The MIT License (MIT)
Copyright (c) 2023-2026 iobroker-community-adapters iobroker-community-adapters@gmx.de
Copyright (c) 2018-2021 ldittmar iobroker@lmdsoft.de, Jens Maus mail@jens-maus.de
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.