Samsung Smart TV Smart-Home-Integration, kostenlos und Open Source
Control your Samsung Smart TVs (Tizen) over the local network: power, volume, mute and input source.
Veröffentlicht von cicoub13
- Geräte
- Version 1.1.0
- Erfordert Gladys >=4.86.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
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.
Konfigurationseinstellungen
Diese Einstellungen fragt Samsung Smart TV in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Finding your TV | section | Nein | 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 | Nein | 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 | Nein | How often the power state, volume and mute are read back from the TV. |
So installierst du Samsung Smart TV in Gladys
- Öffne in Gladys Integrationen: Samsung Smart TV erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/cicoub13/gladys-samsung-tv:1.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/cicoub13/gladys-samsung-tv.
Samsung Smart TV benötigt Gladys >=4.86.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Samsung Smart TV ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von cicoub13 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle externen Integrationen durchsuchen
- Die nativen Integrationen entdecken, die in Gladys eingebaut sind
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation