Integración domótica Toulouse Agenda, gratuita y de código abierto
Conciertos, espectáculos y exposiciones en Toulouse: widget, avisos y resumen del fin de semana.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Conciertos, espectáculos, exposiciones, proyecciones, encuentros y talleres en Toulouse y su área metropolitana, en Gladys: un widget de panel «esta noche / este fin de semana», un desencadenante de escena cuando se anuncia un evento que contiene sus palabras vigiladas (un artista, una sala, «jazz», «gratuit»…) y una acción de escena que escribe la lista de las salidas del fin de semana, lista para enviar.
Los eventos proceden de datos abiertos, gratis y sin cuenta: OpenAgenda (las agendas de las bibliotecas, museos y monumentos de la ciudad, del Quai des Savoirs, del Cratère, los conciertos y fiestas de Shotgun, las agendas de los municipios del área…) y la agenda «So Toulouse» de Toulouse Métropole.
Lo que necesita
- Gladys 5.1.0 o posterior.
- Acceso a Internet desde Gladys: la integración descarga la agenda de
public.opendatasoft.comydata.toulouse-metropole.fr, y las miniaturas de los eventos deimg.openagenda.com. - Nada más: ni cuenta ni clave de API.
Instalación
- En Gladys, abra Integraciones, busque Toulouse Agenda en la tienda
(categoría Servicios) e instálela — o Instalar desde GitHub con la
dirección
https://github.com/guim31/gladys-toulouse-agenda. - La primera descarga empieza enseguida y dura unos segundos.
- Añada el widget Salidas en Toulouse a un panel y escriba sus palabras vigiladas en la configuración si quiere que le avisen de los nuevos eventos.
Ajustes
| Ajuste | Lo que hace |
|---|---|
| Palabras vigiladas | Palabras separadas por comas: un artista, una sala, un estilo, «gratuit»… Cada evento nuevo que contenga una activa «Nuevo evento anunciado». Vacío: el desencadenante nunca se activa. |
| Palabras excluidas | Palabras separadas por comas: los eventos que contengan una se ocultan en todas partes (widget, resumen, desencadenante). Útil para lo que no le interesa («recrutement», «aidants»…). |
| Radio de búsqueda | 5, 10, 15 o 25 km alrededor del Capitole. 15 km (por defecto) cubren casi todo Toulouse Métropole: Blagnac, Colomiers, Balma, Ramonville, Tournefeuille… |
| Descargar cada | 1, 3 (por defecto), 6 o 12 horas. |
| Idioma de los textos de escena | Idioma de las fechas y etiquetas que envían el desencadenante y la acción de resumen (francés por defecto). El widget sigue el idioma de cada usuario. |
El botón Descargar ahora descarga la agenda enseguida e indica cuántos eventos hay próximamente y cuántos corresponden a cada palabra vigilada: así puede comprobar una palabra antes de contar con ella.
Cómo se reconocen las palabras, en todas partes (palabras vigiladas, palabras excluidas, palabras clave del widget y de la acción): sin distinguir mayúsculas ni acentos, solo palabras enteras («rap» no encuentra «rapport»), varias palabras forman una expresión («jeune public»). Se buscan en el título, las palabras clave, el lugar, la dirección, el municipio, la agenda de origen, la descripción y el precio. Un evento gratuito también responde a «gratuit», «free», «gratis» y «kostenlos».
Widget «Salidas en Toulouse»
Una lista de 8 salidas como máximo, las más próximas primero, con su miniatura, el momento y el lugar, y una insignia: Gratis, Completo o su tema. Toque una línea para leer la descripción, las fechas, la dirección, el precio y el enlace a la ficha del evento.
Cada widget tiene sus propios ajustes:
- Periodo: hoy, esta noche (de 18:00 a 05:00), mañana, este fin de semana (del viernes 18:00 al domingo a medianoche; de lunes a jueves, el próximo fin de semana), los próximos 7 o 30 días.
- Temas: marque los que quiera (música, espectáculo, exposición, cine, festival, en familia, encuentro, taller, visita). Nada marcado: todos.
- Palabras clave y Municipios: separados por comas; un evento debe contener uno.
- Solo gratis.
- Incluir exposiciones y largas series: desactivado por defecto, para que un museo abierto todos los días no llene «esta noche». Un evento es una larga serie cuando tiene más de 7 fechas o dura más de 14 días.
Varios widgets con ajustes distintos pueden convivir: «Esta noche», «Este fin de semana · música», «Gratis para los niños esta semana»…
Desencadenante «Nuevo evento anunciado»
Se activa cuando un evento nuevo de la agenda contiene una de las palabras vigiladas de la configuración. Nuevo significa nunca visto por su Gladys: la primera descarga solo toma nota de lo que existe, en silencio, igual que un cambio del radio de búsqueda. Cada evento se activa una vez, con la primera palabra vigilada que contiene (en el orden de la configuración). 20 eventos como máximo por descarga, los más próximos primero.
Filtros del desencadenante (todos opcionales):
- Palabra vigilada: una de las palabras de la configuración, escrita exactamente igual. Vacío: cualquier palabra vigilada.
- Tema principal: el primer tema del evento.
- Gratis: gratis, o de pago / sin precisar.
- Municipio: nombre exacto, p. ej.
Toulouse.
Información transmitida a la escena: evento, fecha (p. ej. «sáb, 18 oct, 20:00»), lugar, municipio, enlace, palabra vigilada, tema, precio, descripción y el inicio en formato ISO 8601.
Acción de escena «Salidas en Toulouse»
Escribe la lista de las salidas de un periodo con los mismos filtros que el widget (periodo, temas, palabras clave, municipios, solo gratis, largas series) y un número de líneas (5 por defecto, 15 como máximo); las demás se cuentan. Resultados disponibles para los pasos siguientes: Resumen (el texto), Número de salidas, Primera salida y Enlace de la primera salida.
Ejemplo de resumen (con el idioma de los textos de escena en francés):
Ce week-end à Toulouse : 14 sorties.
• ven. 16 oct., 17:30 — Venez fêter Martror ! · Halle Lauragaise de Castanet-Tolosan
• ven. 16 oct., 18:30 — Éloge de la folie · Archives municipales
• ven. 16 oct., 18:30 — Sesilha (session musiques trad) · COMDT (Gratuit)
Et 11 autres.
Ejemplos de escenas
- El fin de semana, el viernes por la tarde: desencadenante «Cada semana», el viernes a las 18:00 → acción «Salidas en Toulouse» (periodo: este fin de semana, temas: música y espectáculo) → «Enviar mensaje» con el Resumen.
- No perderse ninguna fecha: palabras vigiladas
Orelsan, Zénith, jazz; desencadenante «Nuevo evento anunciado» (sin filtro) → «Enviar mensaje»: «Nuevo en Toulouse: {evento}, {fecha} en {lugar} — {enlace}». - Salidas gratis para los niños: desencadenante «Cada semana», miércoles y sábado a las 09:00 → acción «Salidas en Toulouse» (periodo: hoy, tema: en familia, solo gratis) → condición «Número de salidas» mayor que 0 → enviar el Resumen.
Temas
OpenAgenda no tiene una categoría común, solo las palabras clave de los organizadores: los temas se deducen del título, las palabras clave y el nombre de la agenda (y de las categorías de So Toulouse). Un evento puede tener varios temas, o ninguno: un evento sin tema solo aparece si no hay ningún tema marcado. El tema principal que usa el desencadenante es el primero en este orden: música, espectáculo, exposición, cine, festival, en familia, encuentro, taller, visita.
Solución de problemas
- El widget muestra «Primera descarga en curso»: Gladys no alcanza
public.opendatasoft.comnidata.toulouse-metropole.fr. La integración vuelve a intentarlo cada 15 minutos; los registros de la integración dicen por qué. - «No se ha podido descargar la agenda» bajo la lista: las dos fuentes fallaron en la última descarga; la lista muestra los eventos de la anterior.
- El desencadenante nunca se activa: compruebe que hay una palabra vigilada y pulse Descargar ahora: el mensaje cuenta los eventos de cada palabra. Solo los eventos anunciados después de escribir la palabra activan la escena.
- Falta un evento: quizá no está en OpenAgenda (cada lugar elige dónde publica), está fuera del radio de búsqueda, cancelado, solo en línea u oculto por una palabra excluida.
Límites
- La cobertura depende de los organizadores: OpenAgenda reúne las bibliotecas, los museos y muchos lugares de la ciudad, pero no todas las salas de conciertos publican allí. Los datos abiertos So Toulouse de Toulouse Métropole no se actualizan desde diciembre de 2025 (en octubre de 2026): se leen de todos modos, para el día en que vuelvan.
- Los títulos y descripciones se quedan en francés, como los escribieron los organizadores.
- Las horas se leen en la hora de Toulouse, sea cual sea la zona horaria de Gladys.
- Los eventos de la agencia de empleo (France Travail) se descartan: no son salidas.
Fuentes de datos, licencia y cuotas
- Eventos públicos de OpenAgenda, a través del portal de datos abiertos de
Opendatasoft (
evenements-publics-openagenda), Licence Ouverte / Etalab. - «Agenda des manifestations culturelles - So Toulouse», datos abiertos de Toulouse Métropole, Licence Ouverte / Etalab 2.0.
La fuente y la fecha de la última descarga aparecen en el detalle de cada evento, como pide la licencia. Cada descarga es una petición por fuente (unos 3 MB), cada 3 horas por defecto: muy por debajo de las cuotas anónimas de los portales (decenas de miles de peticiones al día).
Privacidad
La integración no envía nada sobre usted: descarga datos públicos. Guarda en su
volumen /data los eventos de la última descarga y los identificadores de los
eventos ya vistos. Sus palabras vigiladas se quedan en Gladys.
Parámetros de configuración
Estos son los parámetros que Toulouse Agenda te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Funcionamiento | section | No | Los eventos culturales de Toulouse y su área metropolitana proceden de los datos abiertos de OpenAgenda (bibliotecas, museos, salas, agendas municipales) y de Toulouse Métropole, bajo Licence Ouverte. Gratis, sin cuenta. Añada el widget «Salidas en Toulouse» a un panel y use el desencadenante y la acción en sus escenas. |
| Palabras vigiladas | string | No | Separadas por comas: un artista, una sala, un estilo, «gratuit»… Cada nuevo evento que contenga una activa el desencadenante «Nuevo evento anunciado». |
| Palabras excluidas | string | No | Separadas por comas: los eventos que contengan una se ocultan en todas partes (widget, resumen, desencadenante). |
| Radio de búsqueda | select | No | Alrededor del Capitole. 15 km cubren casi todo Toulouse Métropole. |
| Descargar cada | select | No | La agenda cambia unas pocas veces al día: cada 3 horas es suficiente. |
| Idioma de los textos de escena | select | No | Fechas y etiquetas que envían el desencadenante y la acción de resumen. El widget sigue el idioma de cada usuario. |
Cómo instalar Toulouse Agenda en Gladys
- En Gladys, abre Integraciones: Toulouse Agenda 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-toulouse-agenda: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-toulouse-agenda.
Toulouse Agenda 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
Toulouse Agenda 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 externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación