Integración domótica Renfe, gratuita y de código abierto

Trenes de Renfe: AVE, larga distancia, Cercanías; retrasos, supresiones, vías.
Descripción
Esta integración lleva a Gladys los trenes de Renfe: la larga y media distancia (AVE, Avlo, Alvia, Intercity, Regional, Avant…) y las Cercanías y Rodalies de cada núcleo (Madrid, Barcelona, Valencia, Sevilla, Bilbao…). Da los próximos trenes, corregidos en tiempo real, con su retraso, en las estaciones que elijas (tres en el formulario, hasta 10 más con un botón), si quieres hacia una estación de destino (con la hora de llegada) y para una sola línea. La vía de un tren de Cercanías se indica en cuanto Renfe la anuncia. También sigue el estado de hasta seis líneas de Cercanías (normal, aviso, alterado, muy alterado), con los avisos de Renfe: obras, huelgas, servicio por carretera. Cada estación y cada línea se convierte en un dispositivo para mostrar en un panel y usar en escenas.
Los datos proceden de los datos abiertos oficiales de Renfe (data.renfe.com), con licencia CC BY 4.0: sin cuenta ni clave. Los dos horarios (GTFS de larga distancia y de Cercanías) solo se descargan cuando Renfe publica otros nuevos, y la integración los guarda. El tiempo real (GTFS-RT) se lee en una petición por red para todas las estaciones seguidas, cada minuto por defecto (cada 10 minutos mientras ninguna estación anuncie nada en la próxima media hora, de noche). Los avisos se leen cada 5 minutos.
Un tren se sigue en tiempo real en cuanto sale de su estación de origen: se dan su hora estimada y su retraso. Antes, es el horario teórico, marcado «(teórico)». Se muestran los trenes suprimidos y las estaciones sin parada.
Es una integración cloud: contacta con ssl.renfe.com (horarios) y gtfsrt.renfe.com (tiempo real). Nada más sale de tu red.
Requisitos
- Gladys Assistant 5.3.0 o posterior.
- Nada más: los datos abiertos de Renfe no piden cuenta ni clave.
Configuración
| Campo | Qué escribir |
|---|---|
| Estación 1, 2, 3 | La estación tal como la escribe Renfe: «Madrid-Atocha Cercanías», «Aranjuez», una parte («Chamartín») o su código. |
| Destino | Solo los trenes que paran después en esta estación, con su llegada. Vacío: todos los trenes que salen. |
| Línea | Solo esta línea: una línea de Cercanías («C3», «R2N») o un producto de larga distancia («AVE», «Avlo»). Vacío: todas. |
| Líneas seguidas | Las líneas de Cercanías cuyo estado sigues, seis como máximo: «C3 Madrid, R2N». |
| Lectura del tiempo real | Cada 30 segundos, minuto, 2 minutos o 5 minutos. |
| Idioma de los textos | Nombres de los dispositivos, resúmenes y salidas de las escenas. Los nombres de estaciones y los avisos van en español. |
Una estación es una estación de Adif, servida tanto por la larga distancia como por las Cercanías: «Madrid-Atocha Cercanías» da las C2 a C10 y los regionales que paran allí; los trenes de alta velocidad salen de «Madrid-Puerta de Atocha-Almudena Grandes», otra estación. El botón Buscar una estación da las estaciones que contienen unas palabras, con su código y sus líneas («Madrid-Atocha Cercanías [18000] → Regional, C3 Madrid…»). Bastan unas palabras cuando una sola estación las contiene («chamartin»).
Una línea de Cercanías se escribe con su núcleo cuando su nombre existe en otro («C1» circula en diez núcleos): «C3 Madrid», «C1 Sevilla», «Rodalies R2»; sola, es la que pasa por tus estaciones. Probar la conexión vuelve a pedir los horarios y lee al momento cada estación y cada línea.
Más estaciones que las tres del formulario (casa, trabajo, un trayecto semanal…): Añadir una estación toma los mismos tres campos — estación, destino, línea — y sigue hasta 10 estaciones más. Listar las estaciones muestra todas las estaciones seguidas, numeradas; Quitar una estación toma ese número (o el nombre). Las estaciones añadidas se guardan en la configuración de Gladys, así que siguen sus copias de seguridad.
El horario de Cercanías es un archivo grande: la primera lectura, y la de cada archivo nuevo, tarda unos 10 a 30 segundos.
Uso
Dispositivos
En la pestaña Descubrir, crea los dispositivos que quieras:
- Renfe <estación> → <destino>: el próximo tren en texto («C3 → Aranjuez · 3 min (+2 min de retraso) · vía 2 · llegada 23:13», «AVE 3063 → Barcelona-Sants · 06:27 (teórico)»), la espera del próximo tren y del siguiente (minutos), y el retraso del próximo (minutos, publicado solo cuando se sigue en tiempo real);
- Renfe Cercanías Madrid C3, Renfe Rodalies R2N…: el estado en texto («Servicio alterado: Por obras de mejora…») y el número de avisos en curso.
Sin tren en las próximas cuatro horas, el dispositivo muestra el primero de cada trayecto de las 24 horas siguientes.
Estado del servicio
Renfe publica avisos para las Cercanías: un texto en español, las líneas afectadas y sus periodos. El estado de una línea sale de su aviso más grave en curso: muy alterado por una interrupción o un servicio por carretera, alterado por obras, una huelga, retrasos, frecuencias modificadas, aviso en los demás casos (ascensores averiados, billetes); normal sin aviso. Un aviso que empieza en los próximos tres días se muestra como «próximamente». Los avisos que solo afectan a una estación (un ascensor, un acceso) se dejan fuera. La larga distancia no tiene avisos: sus retrasos y supresiones son los de los trenes.
Widgets del panel

- Salidas Renfe: los próximos trenes de una estación, en compacto. Una fila por línea y destino, con sus próximos trenes seguidos («8 · 52 min»). Un tren suprimido se muestra («suprimido 22:35») y pone la fila en naranja, como un retraso de 5 minutos o más. El ajuste Trayectos mostrados fija el número de filas. Elige una estación seguida, o escribe cualquier estación (y una línea) en los ajustes del widget. Con Varias estaciones, un widget muestra varios dispositivos estación: los de una misma estación se reúnen bajo su nombre; para estaciones distintas, cada una empieza con una fila propia.
- Estado del servicio Renfe: el estado de cada línea, luego los avisos en curso y los de los próximos tres días, con su periodo. Toca una tarjeta para ver el texto completo. Las líneas seguidas, las escritas en los ajustes, o las líneas de Cercanías de tus estaciones si no sigues ninguna.
Escenas
Disparadores, una vez por cambio (la primera lectura es solo una referencia):
- Renfe: salida próxima: un tren de una estación seguida sale dentro de 2, 3, 5, 10, 15, 20 o 30 minutos, contados sobre su estimación en tiempo real.
- Renfe: tren con retraso: un tren de una estación seguida que sale en las próximas dos horas lleva 5, 10, 15, 30 o 60 minutos de retraso o más, una vez por tren y umbral.
- Renfe: tren suprimido: un tren de una estación seguida que sale en las próximas dos horas está suprimido, o ya no para allí.
- Renfe: línea alterada: una línea seguida pasa a alterada o muy alterada.
- Renfe: fin de la incidencia: ya no hay ninguna incidencia en curso en la línea.
- Renfe: nuevo aviso: Renfe publica un aviso sobre una línea seguida, en curso o próximo.
Cada uno da una frase lista, {{triggerEvent.data.summary}}, y sus valores (línea, número de tren, destino, hora, retraso, vía, título, texto, inicio y fin…). Las acciones Renfe: próximos trenes y Renfe: estado de una línea devuelven el mismo tipo de valores, para ponerlos en un mensaje o probarlos en una condición.
Ejemplos:
- Cuando tu C3 a Aranjuez sale dentro de 10 minutos → poner en verde la lámpara de la entrada.
- Cuando tu AVE a Barcelona lleva 15 minutos de retraso o está suprimido → enviar el resumen al móvil antes de salir.
- Cada día laborable a las 7:30 → leer los próximos trenes de tu estación y que el altavoz de la cocina los anuncie.
Transporte
Solo cloud: los datos vienen de internet. Los horarios cuando Renfe publica otros nuevos, el tiempo real de las redes de tus estaciones en una petición cada una, los avisos cada 5 minutos.
Solución de problemas
- «Desconocido o ambiguo»: usa Buscar una estación y copia el nombre exacto o el código entre corchetes; para una línea de Cercanías, añade su núcleo («C1 Sevilla»).
- «(teórico)» tras un tren: aún no ha salido de su estación de origen, o Renfe no lo sigue; la hora es la del horario.
- Ningún tren hacia el destino: el destino debe ser una estación donde los trenes paran después de la tuya; comprueba el nombre con Buscar una estación, o vacía el destino para ver todos los trenes.
- Una huelga, muchos trenes suprimidos: Renfe anuncia las supresiones del día; se muestran para las próximas seis horas, nunca para los días siguientes.
- «Los datos abiertos de Renfe no responden»: la integración lo vuelve a intentar en cada lectura; mientras tanto los trenes vienen de los horarios guardados, y una lectura de menos de 3 minutos sustituye a una rechazada.
- Para informar de un problema: pulsa Diagnóstico y copia las líneas que empiezan por «Renfe diagnostic» de la pestaña Registros en una issue de GitHub o una respuesta en el foro, con las versiones de Gladys y de la integración.
Parámetros de configuración
Estos son los parámetros que Renfe te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Datos abiertos de Renfe | section | No | Los trenes proceden de los datos abiertos oficiales de Renfe: los horarios (GTFS) de larga y media distancia (AVE, Avlo, Alvia, Intercity, Regional…) y de las Cercanías y Rodalies de cada núcleo, y su tiempo real (GTFS-RT: retrasos, supresiones, vías, avisos). Sin cuenta ni clave: rellena tus estaciones y líneas abajo y pulsa «Probar la conexión». |
| Estación 1 | section | No | La estación donde tomas el tren: sus próximas salidas, del horario corregido en tiempo real, con su retraso, su vía (Cercanías) y su llegada a tu destino. |
| Estación | string | No | Su nombre tal como lo escribe Renfe («Madrid-Chamartín-Clara Campoamor», «Aranjuez»), una parte si solo una estación la contiene («Chamartín»), o su código: el botón «Buscar una estación» los da. |
| Destino | string | No | Solo los trenes que paran después en esta estación, con su hora de llegada. Vacío para todos los trenes que salen de la estación. |
| Línea | string | No | Solo esta línea: una línea de Cercanías («C3», «R2N») o un producto de larga distancia («AVE», «Avlo», «Regional»). Vacío para todas las líneas. |
| Estación 2 | section | No | |
| Estación | string | No | |
| Destino | string | No | Solo los trenes que paran después en esta estación, con su hora de llegada. Vacío para todos los trenes que salen de la estación. |
| Línea | string | No | Vacío para todas las líneas. |
| Estación 3 | section | No | Más estaciones (casa, trabajo, un trayecto semanal…): el botón «Añadir una estación», bajo el formulario, sigue hasta 10 más, «Listar las estaciones» las muestra todas, numeradas, y «Quitar una estación» deja de seguir una. |
| Estación | string | No | |
| Destino | string | No | Solo los trenes que paran después en esta estación, con su hora de llegada. Vacío para todos los trenes que salen de la estación. |
| Línea | string | No | Vacío para todas las líneas. |
| Estado de las líneas de Cercanías | section | No | Las líneas de Cercanías y Rodalies cuyo estado sigues: un dispositivo por línea, con su estado (normal, aviso, alterado, muy alterado) deducido de los avisos de Renfe, y sus mensajes (obras, huelgas, servicio por carretera), leídos cada 5 minutos. La larga distancia no tiene avisos: sus retrasos y supresiones están en las estaciones. |
| Líneas seguidas | string | No | Hasta 6, separadas por comas, con su núcleo («C3 Madrid», «C1 Sevilla», «R2N»), o sin él cuando tus estaciones lo indican. |
| Opciones | section | No | |
| Lectura del tiempo real | select | No | Cada cuánto se lee el tiempo real: una petición por red para todas las estaciones seguidas. Mientras ninguna estación anuncie nada en la próxima media hora (de noche), cada 10 minutos. Los horarios se leen una vez al día. |
| Idioma de los textos | select | No | Nombres de los dispositivos, resúmenes y salidas de las escenas. Automático: el idioma de tu panel, en cuanto se haya mostrado un widget de Renfe. Los nombres de estaciones y los avisos quedan en español. |
Cómo instalar Renfe en Gladys
- En Gladys, abre Integraciones: Renfe 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/william-de71/gladys-renfe:0.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/William-De71/gladys-renfe.
Renfe requiere Gladys >=5.3.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
Renfe 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 William-De71, 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