Integración domótica Samsung Smart TV, gratuita y de código abierto
Control your Samsung Smart TVs (Tizen) over the local network: power, volume, mute and input source.
Publicado por cicoub13
- Dispositivos
- Versión 1.1.0
- Requiere Gladys >=4.86.0
- ★ 0
La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.
Control your Samsung televisions (Tizen, 2016 models onwards) from Gladys, entirely over the local network: no Samsung account, nothing going through the cloud.
What the integration exposes
| Feature | Detail |
|---|---|
| Power | Turns the TV off, and wakes it up with Wake-on-LAN |
| Volume | A 0 to 100 % slider, showing the level actually read back from the TV |
| Volume up / down | One volume step, like the remote |
| Mute | Set or cleared, never toggled blindly |
| Source | TV, HDMI, and the installed apps when the TV reports them |
Setup
-
Turn your television on, then open the Discovery tab and run a scan. It shows up under its own name ("Samsung AU7025 55 TV", for instance). Create it.
A TV in standby shuts its network interface down: it answers nothing and no scan can find it. A scan that comes back empty is almost always a television that is off — switch it on and scan again.
-
Run a first command, Volume up for example. The TV then displays an authorization prompt for "Gladys": accept it with the remote. This happens only once, the token is kept afterwards.
If the TV asks nothing and commands keep failing, check that Settings → General → External Device Manager → Device Connection Manager still allows new devices.
Turning the TV back on
A TV that is off answers nothing on the network: the only way in is Wake-on-LAN, a packet Gladys emits towards its MAC address. This requires the wake-on-network option to be enabled on the TV, under Settings → General → Network → Expert settings → Power On with Mobile (the wording varies across models).
Over Wi-Fi this wake-up depends on the model and is not guaranteed by every television. If turning on does not work while the option is enabled, an Ethernet link makes it reliable. Turning off always works.
To find out where you stand, turn the TV off, then run ping <TV IP address> from any machine on the network:
- the TV still answers: its network interface stays alive in standby, and Wake-on-LAN has every chance of working;
- the TV answers nothing at all: it shut its network interface down, no packet can reach it any more and the wake-up will fail. That is the symptom of a disabled wake-on-network option — enable it, then run the test again.
Sources and applications
TV and HDMI are always offered: they are remote-control keys, present on every model.
The list of installed applications is requested from the TV during the scan, but several recent models (2021 and later) ignore that request. When that happens only TV and HDMI show up — that is expected behaviour, not a failure. Run a new scan after installing an app: if your model answers, it will be added.
How it works
Three channels, each for what it does best:
- the TV REST API (port 8001) reports the power state, read on every refresh;
- UPnP RenderingControl (port 9197) reads and writes the volume level and the mute state, with no token involved;
- the remote-control WebSocket (port 8002) carries key presses, the only part needing the authorization.
The pairing token is kept in the integration's /data volume: it survives restarts and container updates.
Parámetros de configuración
Estos son los parámetros que Samsung Smart TV te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Finding your TV | section | No | Turn the television ON before running a scan from the Discovery tab. A TV in standby cuts its network interface off: it answers nothing, and no scan can find it. If the scan comes back empty, switch the TV on, wait a few seconds, and scan again. |
| Before you start | section | No | Two settings on the TV itself matter. The first time Gladys sends a command, the TV asks you to authorize it: accept on screen, this happens only once. To turn the TV back ON, Gladys sends a Wake-on-LAN packet, which requires the wake-on-network option to be enabled on the TV (Settings > General > Network > Expert settings). |
| Refresh interval | select | No | How often the power state, volume and mute are read back from the TV. |
Cómo instalar Samsung Smart TV en Gladys
- En Gladys, abre Integraciones: Samsung Smart TV aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/cicoub13/gladys-samsung-tv:1.1.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/cicoub13/gladys-samsung-tv.
Samsung Smart TV requiere Gladys >=4.86.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Samsung Smart TV es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene cicoub13, no el equipo principal de Gladys.
- Explorar todas las integraciones externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación