Integración domótica Kaleidescape, gratuita y de código abierto
Kaleidescape movie players on the local network: power, play, pause, stop, title, video format.
Publicado por LM1LC3N7
- Dispositivos
- Versión 0.1.1
- Requiere Gladys >=5.1.0
- ★ 0
La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.
Control your Kaleidescape movie players (Strato, Compact Terra Prevue, Alto, Cinema One, M-Class) from Gladys, locally, without any cloud: power on, standby, play, pause, stop, remote keys, play status, title, chapter, movie location and video format.
Important. This integration was never tested with a real device: it was written from the
pykaleidescapelibrary (the one of Home Assistant) and tested against a fake player only. Your feedback is welcome. Unofficial integration, not affiliated with Kaleidescape.
Installation
- Give the player a fixed IP address in your router (reserved DHCP lease).
- In Gladys, install the Kaleidescape integration, open its
configuration and type the IP addresses of the players, separated by
commas (for example
192.168.1.60; port 10000 by default, another one as192.168.1.60:10001). - The players appear in the Discovery tab: create them.
The control protocol has no password: nothing else to type. A server without a movie zone (Terra, 1U, 3U) is not offered.
What you get
| Feature | Gladys type | Note |
|---|---|---|
| Power | binary state (read only) | 1 on, 0 standby or not reachable |
| Power status | text (read only) | On, Standby, Not reachable |
| Power on | button | sent from standby only |
| Standby | button | sent when on only; never blocked |
| Play | button | sent when on only |
| Pause, Stop | buttons | sent only when a movie plays; never blocked |
| Remote key | dropdown | arrows, OK, Back, menu, next / previous chapter… |
| Playing | binary state (read only) | 1 while playing (or scanning) |
| Play status | text (read only) | Idle, Paused, Playing, Fast forward, Rewind |
| Title | text (read only) | the title playing, "No title" when nothing plays |
| Chapter | number (read only) | 0 when nothing plays |
| Movie location | text (read only) | None, Content, Intermission, Credits, Disc menu |
| Video mode | text (read only) | for example 3840x2160p24 16:9 |
| Dynamic range | text (read only) | SDR, HDR, HDR10 (PQ), Unknown |
On purpose, no switch: an "everything off" or "everything on" of a voice assistant or a scene never reaches your player. Use the buttons in your scenes. Example: dim the lights when "Playing" turns 1, light them again when "Movie location" becomes "Credits".
Commands
The state of the player (its serial number, power and play status) is read again just before every command. When another player answers at the address, nothing is sent and the address is forgotten; an unreadable serial number does not count as another player.
- Power on is sent from standby only; Play and the remote keys only when the player is on (otherwise: refused, nothing sent). These commands go one at a time.
- Standby, Pause and Stop are protective: they never wait in the queue, are never refused because the state could not be read (they are sent anyway), and they cancel the Power on, Play or remote key commands still waiting ("Cancelled by …, nothing sent").
- A command is answered as done only when the state read afterwards is the one asked (power, playing, paused, stopped); a remote key, when the player accepts it. Otherwise: "Sent, without confirmation from the player". A command that could not leave says "nothing sent", a refusal of the player "refused by the player".
Every command is answered within 4 seconds (Gladys waits 5 seconds); it never leaves after its deadline.
Configuration button
- Check the players: tells the known state of each player and each typed address, with the age of the last read. It reads a player again only when its interval has passed.
Refresh, status and limits
- The state of each player is read every 15 seconds by default (10 to 300), in one short connection. Never more often: neither the reconnection to Gladys, nor a configuration save, nor the button, nor the creation of the device, nor a restart reads sooner (the time of the last read is kept in the data folder).
- An address where no player is identified yet is read every minute at most.
- A player that does not answer shows power 0 and "Not reachable", and is named in the status of the integration.
- The title, chapter and video format are read at each refresh: a scene reacts with that delay (no real-time events yet).
Data and privacy
The integration keeps in /data/kaleidescape.json the known players
(serial number, address, port, model, name, number of movie zones) and the
time of the last read of each address. Nothing of what you watch is written
there. Nothing leaves your local network.
Known limits
- No real-time events yet (reads at each interval only).
- No cover art, synopsis nor volume control (the player does not drive the volume).
- A player with several zones is seen as one device (main zone).
- Never tested with a real device: real answers may differ.
Parámetros de configuración
Estos son los parámetros que Kaleidescape te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Your Kaleidescape players, on your local network | section | No | Power on, standby, play, pause, stop, remote keys, play status, title, chapter, movie location (credits, intermission) and video format of each Kaleidescape movie player (Strato, Compact Terra Prevue, Alto, Cinema One, M-Class), through the control protocol published by Kaleidescape (TCP port 10000), without any cloud. Give each player a fixed IP address in your router and type it below; the players then appear in the Discovery tab. Every command is a button, never a switch: an "everything off" never reaches a player. Never tested with a real device. Unofficial integration, not affiliated with Kaleidescape. |
| IP addresses of the players | string | No | Separated by commas, for example 192.168.1.60, 192.168.1.61. Port 10000 by default (another one: 192.168.1.60:10001). |
| Refresh interval (s) | number | No | How often the state of each player is read, in seconds (10 to 300). |
Cómo instalar Kaleidescape en Gladys
- En Gladys, abre Integraciones: Kaleidescape 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/lm1lc3n7/gladys-kaleidescape:0.1.1), 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/LM1LC3N7/gladys-kaleidescape.
Kaleidescape requiere Gladys >=5.1.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
Kaleidescape 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 LM1LC3N7, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación