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

Plazas MAX JEUNE y MAX SENIOR en sus trayectos SNCF, y aviso cuando se abren plazas.

• Publicado por William-De71
• Dispositivos
• Versión 0.1.0
• Requiere Gladys >=5.3.0
• ★ 0

Ver en GitHubTodas las integraciones

Presentación

Esta integración sigue las plazas MAX JEUNE (16-27 años) y MAX SENIOR (60 o más) de SNCF, los abonos ilimitados en los TGV INOUI y los Intercités con reserva. Usted declara sus trayectos — «Paris → Lyon, los viernes desde las 17:00», «Lyon → Paris, los domingos» — y cada uno se convierte en un dispositivo: los trenes con plazas MAX abiertas en los próximos 30 días, en 7 días, los días con plazas y el próximo tren abierto. Un disparador de escena le avisa cada mañana cuando se abren plazas MAX en un trayecto, y tres widgets muestran los trenes, un calendario de 30 días y todos sus trayectos.

Los datos proceden de los datos abiertos oficiales de SNCF Voyageurs (conjunto «Disponibilité à 30 jours de places MAX JEUNE et MAX SENIOR ouvertes à la réservation»), con licencia ODbL: sin cuenta ni clave. SNCF lo reconstruye una vez al día, temprano por la mañana: la integración comprueba cada 30 minutos si ha cambiado y luego lee los trenes de sus trayectos. Las plazas mostradas son, por tanto, las de la mañana: algunas se agotan durante el día y otras vuelven. Reserve siempre en SNCF Connect, donde las plazas están en directo.

Es una integración en la nube: contacta con ressources.data.sncf.com. Nada más sale de su red.

Requisitos previos

• Gladys Assistant 5.3.0 o posterior.
• Un abono MAX JEUNE o MAX SENIOR, para reservar las plazas en SNCF Connect. Nada más: los datos abiertos de SNCF no requieren cuenta ni clave.

Configuración

Campo / botón	Función
Añadir un trayecto	Estación de salida y de llegada, los días, las fechas (sustituyen a los días), las horas de salida y «seguir también la vuelta» (dos trayectos a la vez).
Modificar un trayecto	Cambia los días, las fechas o las horas de un trayecto (su número en Listar los trayectos, o sus estaciones): el dispositivo se mantiene.
Eliminar un trayecto	Deja de seguir un trayecto. Elimine también su dispositivo en Gladys si ya no lo necesita.
Listar los trayectos	Todos los trayectos seguidos, numerados, con sus trenes con plazas MAX.
Buscar una estación	Las estaciones MAX que contienen algunas palabras: «marseille» da Marseille St Charles y Marseille Blancarde.
Probar la conexión	La fecha de los datos, el número de estaciones y las peticiones que quedan hoy.
Idioma de los textos	Nombres de los dispositivos, próximo tren y resúmenes de escenas. Automático: el idioma del panel (francés mientras no se muestre ningún widget).

Estaciones. Escriba una ciudad o una estación como la llama SNCF. «Paris», «Lyon» y «Lille» abarcan todas las estaciones de la ciudad: Paris → Lyon sigue todos los trenes desde cualquier estación de París hacia Part-Dieu o Perrache. Una estación sola: «Lyon St Exupery», «Aix en Provence TGV», «Marne la Vallee». Cuando un nombre puede designar varias estaciones («Marseille», «Avignon», «Valence»), la integración las enumera: escriba la que desee. Las estaciones extranjeras funcionan en francés o en su idioma («Barcelona», «Ginebra», «Basilea»).

Días y horas. Todos los días, de lunes a viernes, los fines de semana, de viernes a domingo o un día de la semana; o hasta diez fechas (06/11, 08/11/2026, +3), que sustituyen a los días. Las horas son las de salida: «desde 17» y «antes de 21» conservan los trenes que salen de 17:00 a 20:59. Al añadir el trayecto, la integración comprueba que circulan trenes MAX entre las dos estaciones.

Los trayectos se guardan en la configuración de Gladys, por lo que siguen sus copias de seguridad. Hasta 20 trayectos.

Uso

Dispositivos

En la pestaña Descubrimiento, cree los dispositivos TGV MAX <salida> → <llegada>. Cada uno tiene cuatro funciones:

• Trenes con plazas MAX: los trenes del trayecto con plazas MAX abiertas en los próximos 30 días;
• Trenes con plazas MAX en 7 días;
• Días con plazas MAX: las fechas con al menos un tren abierto;
• Próximo tren con plazas MAX: «sáb, 31 oct · 07:00 → 08:56 · tren 6603», o «Ninguno».

Un tren que ya salió hoy deja de contarse, aunque los datos de la mañana todavía lo incluyan.

Widgets del panel

• Trenes MAX: tres mosaicos (trenes abiertos, en 7 días, días), luego los próximos trenes abiertos con sus estaciones («Paris Gare de Lyon → Lyon Part-Dieu») y el tiempo hasta la salida, la hora de los datos y un botón hacia SNCF Connect. El ajuste Trenes mostrados fija la longitud de la lista.
• Calendario MAX: los trenes abiertos de cada día del trayecto durante 30 días, en barras, el día con más plazas y el próximo tren.
• Mis trayectos MAX: todos los trayectos seguidos en una tarjeta, con su número de trenes abiertos, o «Ninguno».

Escenas

Disparadores (la primera lectura de un trayecto solo sirve de referencia):

• TGV MAX: nuevas plazas MAX: se abrieron plazas MAX en trenes de un trayecto seguido que no tenían la víspera, o en un nuevo día del conjunto de datos (añade uno cada mañana, a 30 días). Un solo evento por trayecto y por mañana, aunque se abran diez trenes: {{triggerEvent.data.summary}} los enumera, count da su número, first_date_text, first_departure, first_train y days_until describen el primero.
• TGV MAX: sin plazas MAX: un trayecto seguido tenía trenes abiertos y ya no le queda ninguno.

Acciones:

• TGV MAX: buscar plazas MAX: los trenes con plazas MAX entre dos estaciones en una fecha (hoy, mañana, 06/11, +3; dentro de 30 días), en una franja horaria. Salidas: found, count, el primer tren, un summary. No hace falta seguir ningún trayecto.
• TGV MAX: leer un trayecto seguido: sus trenes abiertos, sus días con plazas, el próximo tren y un summary.

Ejemplos:

• Cuando se abran nuevas plazas MAX en Paris → Lyon (los viernes desde las 17:00) → enviar el resumen a su teléfono.
• Cuando un trayecto se quede sin plazas MAX → encender la lámpara del escritorio en rojo.
• Cada jueves a las 8:00 → buscar plazas MAX de Lyon a Paris para mañana; si found es verdadero, hacer que el altavoz de la cocina lea el resumen.

Transporte

Solo en la nube: los datos vienen de internet. Solo las estaciones de sus trayectos se envían al portal de SNCF.

Solución de problemas

• «Ninguna estación MAX se llama …»: use Buscar una estación y escriba el inicio del nombre de la ciudad. MAX solo cubre los TGV INOUI y los Intercités con reserva: las estaciones de TER y OUIGO no aparecen.
• «Ningún tren MAX va de … a …»: ningún tren MAX une estas dos estaciones en los próximos 30 días. Pruebe la ciudad («Paris») en lugar de una estación, o la otra estación de la ciudad.
• Las plazas mostradas ya no están en SNCF Connect: los datos son de la mañana y las plazas vuelan. Los widgets muestran la hora de los datos.
• Nada se dispara el primer día: la primera lectura de un trayecto es una referencia; el disparador funciona a partir de la mañana siguiente, cuando se abren plazas.
• «Cuota diaria agotada»: demasiadas peticiones hoy desde su dirección de internet (otros programas pueden compartirla); las lecturas se reanudan tras la medianoche (UTC).
• «El portal de datos abiertos de SNCF no responde»: la integración lo vuelve a intentar cada 30 minutos; los últimos trenes se quedan en los widgets.
• Para informar de un problema: copie las respuestas de Probar la conexión y Listar los trayectos 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 TGV MAX te pide en su pantalla de configuración en Gladys.

Parámetro	Tipo	Obligatorio	Descripción
Datos abiertos de SNCF	section	No	MAX JEUNE (16-27 años) y MAX SENIOR (60 o más) son los abonos ilimitados de SNCF en los TGV INOUI y los Intercités con reserva. Esta integración lee los datos abiertos oficiales de SNCF Voyageurs: los trenes con plazas MAX abiertas, con 30 días de antelación, actualizados cada mañana. Sin cuenta ni clave. 1. Pulse «Añadir un trayecto» (Paris → Lyon, los viernes desde las 17:00…). 2. Añada su dispositivo en la pestaña Descubrimiento. 3. Use el disparador de escena «Nuevas plazas MAX» para recibir avisos, y los widgets en el panel. Los datos son de la mañana: reserve en SNCF Connect, donde las plazas están en directo.
Idioma de los textos	select	No	Nombres de los dispositivos, próximo tren y resúmenes de escenas. Automático: el idioma del panel.

Cómo instalar TGV MAX en Gladys

1. En Gladys, abre Integraciones: TGV MAX aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/william-de71/gladys-tgv-max: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).
3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/William-De71/gladys-tgv-max.

TGV MAX 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

TGV MAX 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

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂