Integración domótica Orange TV, gratuita y de código abierto
Decodificador Orange TV: encendido, canales y volumen desde Gladys, widget mando, escenas.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Controle y siga su decodificador Orange TV (UHD 86, TV 4, TV 5, TV 6) desde Gladys, en su red local: enciéndalo o póngalo en espera, vea el canal en pantalla, cambie de canal, suba o baje el volumen y reaccione en sus escenas cuando se enciende la TV o cambia el canal.
La integración usa la API HTTP local del decodificador (puerto 8080), la misma que la aplicación móvil de Orange TV. Sin cuenta, sin nube.
Developed without the hardware: feedback welcome. Desarrollada sin el aparato: sus comentarios son bienvenidos. La integración se ha construido y probado con un simulador fiel a las respuestas publicadas por los proyectos de código abierto que usan esta API, no con un decodificador real. Cuéntenos qué funciona y qué no en GitHub o en el foro de Gladys.
Requisitos
- Un decodificador Orange TV conectado a su Livebox, en la misma red que Gladys.
- Su dirección IP: en la interfaz de la Livebox (
http://192.168.1.1), entre los dispositivos conectados. Resérvela (concesión DHCP estática) para que no cambie. - Gladys 5.1.0 o posterior.
Configuración
En Integraciones → Orange TV → Configuración:
- Dirección IP: la dirección del decodificador, p. ej.
192.168.1.20(puerto 8080 por defecto; escriba192.168.1.20:8081para otro). - Nombre: el nombre del dispositivo en Gladys. Vacío: «Orange TV» seguido de la dirección.
- Hasta tres decodificadores, uno por sección.
- Intervalo de lectura: con qué frecuencia se leen los decodificadores, de 5 segundos a 1 minuto (10 segundos por defecto). Es el retraso antes de que Gladys vea un cambio de canal hecho con el mando.
- Idioma de los nombres: idioma de los nombres de las funciones y de los textos de la integración. Elíjalo antes de añadir los dispositivos: Gladys conserva los nombres dados al crearlos.
Probar los decodificadores lee cada decodificador e indica lo que muestra. Después, añada los dispositivos desde la pestaña Descubrimiento.
Dispositivos
Un dispositivo por decodificador, con estas funciones:
| Función | Qué hace |
|---|---|
| Encendido / espera | Encendido (1) o en espera (0). Un decodificador que ya no responde cuenta como apagado. Modificable: lo enciende o apaga. |
| Número de canal | Número del canal en directo en el mando, 0 si no hay. Modificable: teclea el número en el mando. |
| Canal | Nombre del canal, o lo que muestra el decodificador: Página de inicio, Vídeo a la carta, En espera, Apagado. |
| Canal siguiente | Botón: canal siguiente. |
| Canal anterior | Botón: canal anterior. |
| Subir volumen | Botón: un paso de volumen más. |
| Bajar volumen | Botón: un paso de volumen menos. |
| Silencio | Botón: quitar o devolver el sonido. |
| Reproducir / pausa | Botón: pausar el directo o un replay, y reanudar. |
La tecla de encendido del mando es un conmutador: la integración lee primero el decodificador y solo la pulsa si hace falta, así que «apagar» nunca enciende un decodificador.
Los nombres de los canales vienen de una tabla de la oferta de Orange incluida en la integración
(canales gratuitos, los principales hasta el 40). Un canal ausente aparece como EPG <id> (su
identificador en la guía de Orange), con el número 0.
Widgets
Mando
El estado del decodificador y el canal en pantalla, con cuatro botones: Encender (o Poner en espera cuando está encendido), y después Canal −, Canal + y Silencio (por defecto) o Volumen −, Volumen + y Silencio (ajuste Botones). Gladys permite cuatro botones por widget: coloque dos widgets Mando uno al lado del otro para el mando completo.
Canales favoritos
Cuatro botones de canales, con los números elegidos en la configuración del widget (TF1, France 2, France 3 y M6 por defecto). El canal en pantalla lleva una marca. Pulsar sobre un decodificador en espera lo enciende primero y después teclea el número.
Disparadores de escena
- Decodificador encendido: el decodificador ha salido del modo de espera. Información transmitida: nombre del decodificador, número de canal, canal.
- Decodificador apagado: el decodificador ha pasado a espera, o ya no responde (filtro Cómo).
Información transmitida: nombre del decodificador, cómo (
standbyounreachable). - Canal cambiado: el decodificador ha cambiado a otro canal en directo (filtro sobre un número de canal, vacío: cualquiera). Información transmitida: nombre del decodificador, número y nombre del canal, número y nombre del canal anterior. Pasar por la página de inicio y volver al mismo canal no es un cambio; el primer canal visto tras un arranque de la integración en la página de inicio o en espera sí lo es, sin canal anterior.
Los eventos se emiten incluso para un decodificador no añadido en Gladys.
Acciones de escena
- Encender o apagar el decodificador: pulsa la tecla de encendido solo si hace falta. Salida: si se ha pulsado la tecla.
- Poner un canal: teclea el número del canal en el mando; enciende antes el decodificador si está en espera (unos 6 segundos). Salidas: número y nombre del canal.
- Pulsar una tecla: OK, atrás, menú, guía de TV, flechas, canales, volumen, silencio, reproducir / pausa, retroceder, avance rápido, grabar, vídeo a la carta, encendido; hasta 10 veces (pasos de volumen).
Sin decodificador elegido, las acciones controlan el primer decodificador de la configuración.
Ejemplos de escenas
- Noticias de la mañana: a las 7:00 entre semana → Poner un canal 16 (franceinfo).
- Noche de cine: Decodificador encendido después de las 20:00 → atenuar las luces del salón.
- Casa tranquila: Decodificador apagado → apagar la regleta de la TV al cabo de 5 minutos.
- Niños: Canal cambiado a un número dado → enviar un mensaje.
Solución de problemas
- «no responde (apagado o dirección incorrecta)»: compruebe la dirección IP en la Livebox; el decodificador debe estar alimentado. En espera profunda (el modo de ahorro de energía del decodificador) deja de responder en la red: aparece entonces como Apagado y solo se enciende con su mando.
- «responde, pero no es un decodificador Orange TV»: la dirección es la de otro aparato.
- El canal aparece como
EPG 1234: el canal no está en la tabla incluida; indíquenos su número y nombre en un issue. - Un canal tecleado es incorrecto: las cifras se teclean con 0,35 s de intervalo; díganos si su decodificador necesita más.
- Registros: Integraciones → Orange TV → Logs;
LOG_LEVEL=debugpara ver cada lectura.
Limitaciones
- Desarrollada sin el aparato: la lectura del modo de espera, de la página de inicio y de las aplicaciones viene de los proyectos de código abierto, no de pruebas con un decodificador real. La «Clé TV» de Orange (Android TV) probablemente no tiene esta API local: no compatible mientras nadie confirme lo contrario.
- Sin guía de programas: el decodificador solo da el identificador del canal en pantalla, y la integración no llama a ningún servicio en línea de Orange.
- Un decodificador en espera profunda no se puede despertar por la red.
- Sin descubrimiento: la dirección IP se introduce en la configuración.
- La API local no tiene contraseña: cualquier persona de su red puede controlar el decodificador, con o sin Gladys. La integración solo envía teclas del mando.
- Sin relación con Orange. Orange es una marca de Orange SA.
Parámetros de configuración
Estos son los parámetros que Orange TV te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Sus decodificadores | section | No | Decodificador Orange TV (UHD 86, TV 4, TV 5, TV 6) en la misma red que Gladys. Encuentre su dirección IP en su Livebox (dispositivos conectados) y resérvela para que no cambie. Hasta tres decodificadores. |
| Dirección IP | string | Sí | Dirección IP del decodificador en su red (puerto 8080 por defecto). |
| Nombre | string | No | Nombre del dispositivo en Gladys. Vacío: «Orange TV» seguido de la dirección. |
| Segundo decodificador (opcional) | section | No | Los mismos campos, para otro decodificador Orange TV de su hogar. |
| Dirección IP | string | No | Dirección IP del decodificador en su red (puerto 8080 por defecto). |
| Nombre | string | No | Nombre del dispositivo en Gladys. Vacío: «Orange TV» seguido de la dirección. |
| Tercer decodificador (opcional) | section | No | Los mismos campos, para otro decodificador Orange TV de su hogar. |
| Dirección IP | string | No | Dirección IP del decodificador en su red (puerto 8080 por defecto). |
| Nombre | string | No | Nombre del dispositivo en Gladys. Vacío: «Orange TV» seguido de la dirección. |
| Opciones | section | No | |
| Intervalo de lectura | select | No | Con qué frecuencia se leen los decodificadores: el retraso de los cambios de canal y estado. |
| Idioma de los nombres | select | No | Idioma de los nombres de las funciones y de los textos de la integración (canal, mensajes de escenas). |
Cómo instalar Orange TV en Gladys
- En Gladys, abre Integraciones: Orange 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/guim31/gladys-orange-tv:1.0.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/guim31/gladys-orange-tv.
Orange TV 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
Orange 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 guim31, 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