Intégration domotique Toulouse Agenda, gratuite et open source

Concerts, spectacles et expos à Toulouse : widget, alertes et résumé des sorties du week-end.

• Publiée par guim31
• Appareils
• Version 1.0.0
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations externes

Concerts, spectacles, expositions, projections, rencontres et ateliers à Toulouse et dans sa métropole, dans Gladys : un widget « ce soir / ce week-end » pour le tableau de bord, un déclencheur de scène quand un événement correspondant à tes mots surveillés est annoncé (un artiste, une salle, « jazz », « gratuit »…), et une action de scène qui écrit la liste des sorties du week-end, prête à envoyer.

Les événements viennent de l'open data, gratuit et sans compte : OpenAgenda (les agendas des bibliothèques, musées et monuments de la ville, du Quai des Savoirs, du Cratère, les concerts et soirées de Shotgun, les agendas des communes de la métropole…) et l'agenda « So Toulouse » de Toulouse Métropole.

Ce qu'il te faut

• Gladys 5.1.0 ou plus récent.
• Un accès Internet depuis Gladys : l'intégration télécharge l'agenda depuis public.opendatasoft.com et data.toulouse-metropole.fr, et les vignettes des événements depuis img.openagenda.com.
• Rien d'autre : ni compte, ni clé d'API.

Installation

1. Dans Gladys, va dans Intégrations, cherche Toulouse Agenda dans le store (catégorie Services) et installe-la — ou Installer depuis GitHub avec l'adresse https://github.com/guim31/gladys-toulouse-agenda.
2. Le premier téléchargement démarre aussitôt et prend quelques secondes.
3. Ajoute le widget Sorties à Toulouse à un tableau de bord, et saisis tes mots surveillés dans la configuration si tu veux être prévenu des nouveaux événements.

Réglages

Réglage	Ce qu'il fait
Mots surveillés	Mots séparés par des virgules : un artiste, une salle, un style, « gratuit »… Chaque nouvel événement qui en contient un déclenche « Nouvel événement annoncé ». Vide : le déclencheur ne part jamais.
Mots exclus	Mots séparés par des virgules : les événements qui en contiennent un sont masqués partout (widget, résumé, déclencheur). Pratique pour ce qui ne t'intéresse pas (« recrutement », « aidants »…).
Rayon de recherche	5, 10, 15 ou 25 km autour du Capitole. 15 km (par défaut) couvrent l'essentiel de Toulouse Métropole : Blagnac, Colomiers, Balma, Ramonville, Tournefeuille…
Télécharger toutes les	1, 3 (par défaut), 6 ou 12 heures.
Langue des textes de scène	Langue des dates et libellés envoyés par le déclencheur et l'action de résumé (français par défaut). Le widget suit la langue de chaque utilisateur.

Le bouton Télécharger maintenant télécharge l'agenda tout de suite et indique combien d'événements sont à venir, et combien correspondent à chaque mot surveillé : le moyen de vérifier un mot avant de compter dessus.

Comment les mots sont reconnus, partout (mots surveillés, mots exclus, mots-clés du widget et de l'action) : sans tenir compte des majuscules ni des accents, par mots entiers (« rap » ne trouve pas « rapport »), plusieurs mots forment une expression (« jeune public »). Ils sont cherchés dans le titre, les mots-clés, le lieu, l'adresse, la commune, l'agenda d'origine, la description et le tarif. Un événement gratuit répond aussi à « gratuit », « free », « gratis » et « kostenlos ».

Widget « Sorties à Toulouse »

Une liste de 8 sorties au plus, les plus proches d'abord, avec leur vignette, le moment et le lieu, et un badge : Gratuit, Complet, ou leur thème. Touche une ligne pour lire la description, les dates, l'adresse, le tarif et le lien vers la fiche de l'événement.

Chaque widget a ses propres réglages :

• Période : aujourd'hui, ce soir (de 18 h à 5 h), demain, ce week-end (du vendredi 18 h au dimanche minuit ; du lundi au jeudi, le week-end qui vient), les 7 ou les 30 prochains jours.
• Thèmes : coche ceux que tu veux (musique, spectacle, exposition, cinéma, festival, en famille, rencontre, atelier, visite). Rien de coché : tous.
• Mots-clés et Communes : séparés par des virgules ; un événement doit en contenir un.
• Gratuit seulement.
• Inclure expositions et longues séries : désactivé par défaut, pour qu'un musée ouvert tous les jours ne remplisse pas « ce soir ». Un événement est une longue série quand il a plus de 7 dates ou s'étale sur plus de 14 jours.

Plusieurs widgets aux réglages différents peuvent cohabiter : « Ce soir », « Ce week-end · musique », « Gratuit pour les enfants cette semaine »…

Déclencheur « Nouvel événement annoncé »

Se déclenche quand un nouvel événement de l'agenda contient l'un des mots surveillés de la configuration. Nouveau veut dire jamais vu par ton Gladys : le premier téléchargement prend seulement note de ce qui existe, en silence, comme un changement du rayon de recherche. Chaque événement déclenche une fois, avec le premier mot surveillé qu'il contient (dans l'ordre de la configuration). 20 événements au plus par téléchargement, les plus proches d'abord.

Filtres du déclencheur (tous facultatifs) :

• Mot surveillé : l'un des mots de la configuration, écrit exactement pareil. Vide : n'importe quel mot surveillé.
• Thème principal : le premier thème de l'événement.
• Gratuit : gratuit, ou payant / non précisé.
• Commune : nom exact, par exemple Toulouse.

Informations transmises à la scène : événement, date (par exemple « sam. 18 oct., 20:00 »), lieu, commune, lien, mot surveillé, thème, tarif, description, et le début au format ISO 8601.

Action de scène « Sorties à Toulouse »

Écrit la liste des sorties d'une période avec les mêmes filtres que le widget (période, thèmes, mots-clés, communes, gratuit seulement, longues séries) et un nombre de lignes (5 par défaut, 15 au plus) ; les autres sont comptées. Résultats disponibles pour les étapes suivantes : Résumé (le texte), Nombre de sorties, Première sortie et Lien de la première sortie.

Exemple de résumé :

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.

Exemples de scènes

• Le week-end, le vendredi soir : déclencheur « Chaque semaine, le vendredi à 18 h » → action « Sorties à Toulouse » (période : ce week-end, thèmes : musique et spectacle) → « Envoyer un message » avec le Résumé.
• Ne plus rater une date : mots surveillés Orelsan, Zénith, jazz ; déclencheur « Nouvel événement annoncé » (sans filtre) → « Envoyer un message » : « Nouveau à Toulouse : {événement}, {date} à {lieu} — {lien} ».
• Sorties gratuites pour les enfants : déclencheur « Chaque semaine », le mercredi et le samedi à 9 h → action « Sorties à Toulouse » (période : aujourd'hui, thème : en famille, gratuit seulement) → condition « Nombre de sorties » supérieur à 0 → envoyer le Résumé.

Thèmes

OpenAgenda n'a pas de catégorie commune, seulement les mots-clés des organisateurs : les thèmes sont déduits du titre, des mots-clés et du nom de l'agenda (et des catégories de So Toulouse). Un événement peut avoir plusieurs thèmes, ou aucun : un événement sans thème n'apparaît que si aucun thème n'est coché. Le thème principal utilisé par le déclencheur est le premier dans cet ordre : musique, spectacle, exposition, cinéma, festival, en famille, rencontre, atelier, visite.

Dépannage

• Le widget affiche « Premier téléchargement en cours » : Gladys n'atteint pas public.opendatasoft.com ni data.toulouse-metropole.fr. L'intégration réessaie toutes les 15 minutes ; les logs de l'intégration disent pourquoi.
• « L'agenda n'a pas pu être téléchargé » sous la liste : les deux sources ont échoué au dernier téléchargement ; la liste montre les événements du précédent.
• Le déclencheur ne part jamais : vérifie qu'un mot surveillé est saisi, puis appuie sur Télécharger maintenant : le message compte les événements de chaque mot. Seuls les événements annoncés après la saisie du mot déclenchent la scène.
• Un événement manque : il n'est peut-être pas sur OpenAgenda (chaque lieu choisit où il publie), hors du rayon de recherche, annulé, seulement en ligne, ou masqué par un mot exclu.

Limites

• La couverture dépend des organisateurs : OpenAgenda porte les bibliothèques, musées et de nombreux lieux de la ville, mais toutes les salles de concert n'y publient pas. L'open data So Toulouse de Toulouse Métropole n'est plus mis à jour depuis décembre 2025 (en octobre 2026) : il est lu quand même, pour le jour où il reviendra.
• Les titres et descriptions restent en français, tels que les organisateurs les ont écrits.
• Les heures sont lues à l'heure de Toulouse, quel que soit le fuseau de Gladys.
• Les événements de France Travail sont écartés : ce ne sont pas des sorties.

Sources des données, licence et quotas

• Événements publics OpenAgenda, via le portail open data d'Opendatasoft (evenements-publics-openagenda), Licence Ouverte / Etalab.
• « Agenda des manifestations culturelles - So Toulouse », open data de Toulouse Métropole, Licence Ouverte / Etalab 2.0.

La source et la date du dernier téléchargement figurent dans le détail de chaque événement, comme le demande la licence. Chaque téléchargement fait une requête par source (environ 3 Mo), toutes les 3 heures par défaut : très en dessous des quotas anonymes des portails (des dizaines de milliers de requêtes par jour).

Vie privée

L'intégration n'envoie rien sur toi : elle télécharge des données publiques. Elle garde dans son volume /data les événements du dernier téléchargement et les identifiants des événements déjà vus. Tes mots surveillés restent dans Gladys.

Paramètres de configuration

Voici les paramètres demandés par Toulouse Agenda dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Fonctionnement	section	Non	Les événements culturels de Toulouse et de sa métropole viennent de l'open data d'OpenAgenda (bibliothèques, musées, salles, agendas des communes) et de Toulouse Métropole, sous Licence Ouverte. Gratuit, sans compte. Ajoute le widget « Sorties à Toulouse » à un tableau de bord, et utilise le déclencheur et l'action dans tes scènes.
Mots surveillés	string	Non	Séparés par des virgules : un artiste, une salle, un style, « gratuit »… Chaque nouvel événement qui en contient un déclenche la scène « Nouvel événement annoncé ».
Mots exclus	string	Non	Séparés par des virgules : les événements qui en contiennent un sont masqués partout (widget, résumé, déclencheur).
Rayon de recherche	select	Non	Autour du Capitole. 15 km couvrent l'essentiel de Toulouse Métropole.
Télécharger toutes les	select	Non	L'agenda change quelques fois par jour : toutes les 3 heures suffit.
Langue des textes de scène	select	Non	Dates et libellés envoyés par le déclencheur et l'action de résumé. Le widget suit la langue de chaque utilisateur.

Comment installer Toulouse Agenda dans Gladys

1. Dans Gladys, ouvrez Intégrations : Toulouse Agenda apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-toulouse-agenda:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-toulouse-agenda.

Toulouse Agenda nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes

Toulouse Agenda est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.

• Parcourir toutes les intégrations externes
• Découvrir les intégrations natives intégrées à Gladys
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂