Aller au contenu principal

Intégration domotique exo, gratuite et open source

Intégration exo pour Gladys Assistant

Non officiel : trains et autobus exo, prochains passages, retards et avis, avec votre clé gratuite.

Intégration non officielle, sans lien avec exo ni l’ARTM. Elle suit jusqu’à quatre arrêts d’exo, les trains et autobus de banlieue de la région de Montréal, et donne pour chacun le prochain passage, le temps d’attente, son retard, les passages annulés et les avis de service. Lecture seule : rien n’est jamais modifié chez exo.

Les données viennent des flux GTFS-Realtime officiels d’exo, servis par le portail développeur Chrono de l’ARTM (Autorité régionale de transport métropolitain), avec votre propre clé gratuite.

Cette intégration a été construite d’après la description publique des flux et testée avec un faux Gladys et un faux portail seulement : elle n’a jamais été testée avec une vraie clé. Les retours des premiers utilisateurs sont les bienvenus sur le forum.

1. Obtenir votre clé gratuite​

  1. Créez un compte sur le portail développeur Chrono.
  2. Abonnez-vous aux données ouvertes d’exo (GTFS-Realtime) et copiez la clé de l’abonnement.

2. Configurer​

  • Clé du portail Chrono : gardée par Gladys dans sa base, jamais réaffichée, envoyée seulement au portail Chrono de l’ARTM (dans l’en-tête Ocp-Apim-Subscription-Key de la passerelle du portail, jamais dans une URL).
  • Arrêt 1 à 4 : le réseau, puis l’arrêt :
    • autobus : le numéro inscrit sur le panneau de l’arrêt (41492), qui est aussi le numéro d’arrêt des données ouvertes d’exo. Le même numéro peut exister sur deux réseaux : le réseau est toujours demandé ;
    • train : le code de la gare (11010 pour la Gare Centrale, tableau plus bas) pour tous les quais de la gare, ou le stop_id d’un quai (MTL5D) pour une seule direction.
  • Lignes (facultatif) : numéros de ligne séparés par des virgules ou des espaces (220, 221) ; pour les trains, le numéro de ligne (11), ses lettres (VH) ou l’identifiant de route (1).
  • Intervalle de lecture : 60 secondes par défaut (30 à 600).
  • Passages pris en compte jusqu’à : les 90 prochaines minutes par défaut (15 à 240).
  • Lire les avis de service : activé par défaut.
  • Langue des valeurs : français ou anglais (noms des fonctionnalités, textes, et texte de l’avis quand exo donne les deux langues).

Tester la clé envoie une requête au portail (au plus toutes les 30 secondes) et dit si la clé est acceptée.

3. Les appareils​

Chaque arrêt apparaît dans l’onglet Découverte dès qu’il est configuré (nom exo <réseau> – <gare> ou exo <réseau> – arrêt <numéro>, avec le filtre de lignes entre parenthèses). Fonctionnalités, toutes en lecture seule :

FonctionnalitéValeur
Prochain passagetexte, par ex. 14:08 · ligne 11 · dans 6 min · +4 min
Prochain passage dansminutes avant le prochain passage maintenu
Retard du prochain passageminutes, négatif en cas d’avance (seulement quand le flux le donne)
Passages annuléspassages de la fenêtre annulés, ou qui ne desservent pas l’arrêt
Avis de serviceavis actifs de l’arrêt, de ses lignes ou de tout le réseau (avis activés)
Avis de service principaltexte du plus grave d’entre eux, Aucun avis sinon (avis activés)

L’heure affichée est celle que prévoit le flux, heure de Montréal. Un passage annulé n’est pas « le prochain passage » : c’est le suivant maintenu. Un passage reste affiché 30 secondes après son heure, puis disparaît.

Les valeurs sont republiées chaque minute à partir de ce qui a été lu (sans requête) : Prochain passage dans décompte entre deux lectures.

Ce qui n’est pas connu n’est pas publié (la dernière valeur reste ; Gladys n’a pas de valeur « inconnue ») :

  • aucun passage dans la fenêtre : le texte le dit, Prochain passage dans et Retard ne sont pas mis à jour (jamais un 0 pour « aucun ») ;
  • un retard que le flux ne donne pas (seulement une heure) : le texte dit retard inconnu et Retard garde le retard d’un passage précédent : lisez-le avec le texte ;
  • l’arrêt absent du flux (numéro mal saisi, autobus sans suivi en temps réel) : le texte dit Aucune prévision en temps réel pour cet arrêt, rien n’est compté ;
  • rien lu depuis 10 minutes (2,5 intervalles s’ils sont plus longs) : rien n’est publié jusqu’à la prochaine bonne lecture ;
  • un flux sans en-tête ou sans heure propre : illisible, rien publié ;
  • un flux dont l’heure propre a plus de 15 minutes de retard sur l’horloge du portail (en-tête Date) : plus du temps réel, rien publié (pas même ce qui a été lu avant), le statut le dit ;
  • avis non lus depuis 20 minutes : les deux fonctionnalités d’avis ne sont pas mises à jour.

Sans l’horaire complet d’exo (non lu : trop gros pour un conteneur), un passage qui ne porte qu’un retard sans heure ne peut pas être placé et il est laissé de côté, et un voyage annulé sans aucune heure pour l’arrêt n’est pas compté. Un avis de ligne compte pour un arrêt quand la ligne est dans son filtre ou, sans filtre, parmi les lignes vues à l’arrêt depuis le démarrage.

4. Comment elle lit le portail, et ses limites​

  • À chaque intervalle, une requête par réseau des arrêts configurés (le flux d’un réseau couvre tous ses arrêts : quatre arrêts du même réseau coûtent une requête), et les avis du réseau toutes les 5 minutes.
  • Une seule requête à la fois, à 1 s d’écart au moins. Un redémarrage, une reconnexion, un enregistrement du formulaire ou le bouton de test n’avancent pas les lectures avant l’intervalle (un arrêt modifié attend 20 s après la dernière lecture). Quand /data ne peut pas être lu au démarrage, la première lecture attend un intervalle entier.
  • HTTP 429 ou réponse de quota de la passerelle du portail (HTTP 403 « quota ») : toutes les requêtes attendent (le délai donné par le portail, sinon 1 minute doublée jusqu’à 6 heures), gardé au redémarrage. Le quota est celui de la clé : saisir une autre clé lève l’attente.
  • 5xx sur le flux d’un réseau : ce réseau attend (1 minute doublée jusqu’à 30 minutes, ou le délai donné par le portail, jusqu’à 6 heures), les autres sont lus normalement ; tous les réseaux essayés en 5xx : toutes les requêtes attendent comme pour un 429.
  • HTTP 401/403 sur le flux d’un réseau : la clé est vérifiée une fois sur les avis des trains. Refusée là aussi : l’intégration s’arrête et ne réessaie pas cette clé d’elle-même, même après un redémarrage ; saisissez une autre clé ou appuyez sur Tester la clé (un succès lève l’arrêt). Après un redémarrage, une nouvelle clé a 1 chance sur 256 de ressembler à la clé refusée (seuls 8 bits en sont gardés) : appuyez alors sur Tester la clé. Acceptée là : seul ce réseau attend (5 minutes, doublées jusqu’à 1 heure).
  • Une erreur sur les avis d’un réseau autre qu’un 429 ou une réponse de quota (401/403 compris, les passages du réseau venant d’être lus avec la même clé) n’arrête pas les passages : ces avis attendent 5 minutes, doublées jusqu’à 1 heure. Un 429 ou une réponse de quota sur les avis met toutes les requêtes en pause, comme plus haut (le quota est celui de la clé).
  • Réponses bornées : 8 Mo pour un flux de passages, 2 Mo pour un flux d’avis, 15 secondes par requête ; une réponse illisible ne publie rien.

5. Ce qui est gardé dans /data​

/data/exo.json : l’heure du dernier tour, une pause, un refus (8 bits d’une empreinte salée de la clé, rien de plus). Aucune clé. Quand le fichier ne peut pas être lu, il n’est pas écrasé et il est relu toutes les 10 secondes ; un fichier illisible comme JSON est d’abord mis de côté sous exo.json.bad.

6. Gares de train​

Code à saisir, nom, stop_id des quais (GTFS des trains d’exo du 2026-10-28 ; une gare plus récente peut être saisie par son stop_id).

CodeGareQuais
11010CentraleMTL5D, MTL5B
11150Lucien-L'AllierMTL3A, MTL3C
11160VendômeMTL2A, MTL2C
11170Montréal-OuestMTL1A, MTL1C
11180LachineLCH1D, LCH1B
11190DorvalDVL2D, DVL2B
11200Pine BeachDVL1D, DVL1B
11210ValoisPCL3D, PCL3B
11220Pointe-ClairePCL2D, PCL2B
11230Cedar ParkPCL1D, PCL1B
11240BeaconsfieldBEA2D, BEA2B
11250BeaurepaireBEA1D, BEA1B
11260Baie-d'UrféBUR1D, BUR1B
11270Sainte-Anne-de-BellevueSAB1D, SAB1B
11280Île-PerrotLIP1D, LIP1B
11290PincourtTVA1D, TVA1B
11300DorionVAU1D, VAU1B
11310VaudreuilVAU8D, VAU8B
11320HudsonHUD1D, HUD1B
11350ParcMTL8D, MTL8B
11355ChabanelMTL37C, MTL37A
11360Bois-de-BoulogneMTL7D, MTL7B
11365De la ConcordeLVL24C, LVL24A
11375VimontLVL22C, LVL22A
11380Sainte-RoseLVL4C, LVL4A
11390RosemèreROS2C, ROS2A
11400Sainte-ThérèseSTR4D, STR4B
11410BlainvilleBLA1C, BLA1A
11420MirabelMIR1C, MIR1A
11430Saint-JérômeSJM1C, SJM1A
11440Saint-LambertSTL1B, STL1D
11450Longueuil-Saint-HubertSTH3B, STH3D
11460Saint-BrunoSTB2B, STB2D
11470Saint-Basile-le-GrandSBA2B, SBA2D
11480McMastervilleMMS1B, MMS1D
11490Mont-Saint-HilaireMSH1C, MSH1A
11495Du CanalLCH4A, LCH4C
11500LaSalleLSL1A, LSL1C
11510Sainte-CatherineSCS2A, SCS2C
11520Saint-ConstantSCS1A, SCS1C
11530DelsonDEL1A, DEL1C
11540CandiacCAN1A, CAN1C
11550AhuntsicMTL59C, MTL59A
11555Côte-de-LiesseMTL60C, MTL60A
11560SauvéMTL58C, MTL58A
11570Saint-Michel-Montréal-NordMTL57C, MTL57A
11580Saint-Léonard-Montréal-NordMTL56C, MTL56A
11590AnjouMTL55C, MTL55A
11600Rivière-des-PrairiesMTL54C, MTL54A
11610Pointe-aux-TremblesMTL53C, MTL53A
11630RepentignyLEG1C, LEG1A
11640TerrebonneLCN1C, LCN1A
11650MascoucheMAS1C, MAS1A

Lignes de train : 11 Vaudreuil-Hudson (VH), 12 Saint-Jérôme (SJ), 13 Mont-Saint-Hilaire (SH), 14 Candiac (CA), 15 Mascouche (MA).

Données et licence​

Données : exo (Réseau de transport métropolitain). Le GTFS statique d’exo (données ouvertes d’exo), d’où viennent les tableaux des gares et des lignes, est sous licence Creative Commons Attribution 4.0 (CC BY 4.0). Les données en temps réel viennent du portail développeur Chrono de l’ARTM, selon les conditions d’utilisation du portail, que vous acceptez à votre inscription. Les données sont modifiées : les prévisions sont filtrées par arrêt et par ligne puis résumées (prochain passage, retard en minutes entières, nombre d’annulations, nombre d’avis et texte du principal). Les tableaux des gares et des lignes viennent du GTFS des trains d’exo.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Clé du portail développeur ChronosectionNonLes passages et les avis viennent des flux GTFS-Realtime officiels d’exo, servis par le portail développeur Chrono de l’ARTM. Créez-y un compte gratuit, abonnez-vous aux données ouvertes d’exo et collez votre clé ci-dessous. Lecture seule : rien n’est jamais modifié chez exo. Intégration non officielle, sans lien avec exo ni l’ARTM. Données : exo. GTFS statique sous CC BY 4.0 ; données en temps réel selon les conditions d’utilisation du portail Chrono, acceptées à votre inscription.
Clé du portail ChronosecretNonLa clé de votre abonnement au portail développeur Chrono. Gardée par Gladys dans sa base, jamais réaffichée, envoyée seulement au portail Chrono de l’ARTM.
ArrêtssectionNonJusqu’à quatre arrêts, un appareil Gladys chacun. Autobus : choisissez le réseau et saisissez le numéro inscrit sur le panneau de l’arrêt (par ex. 41492). Train : choisissez Trains et saisissez le code de la gare (11010 pour la Gare Centrale, liste dans la documentation) pour les deux directions, ou le stop_id d’un quai (MTL5D). Lignes : filtre facultatif, par ex. « 220, 221 » ou la ligne de train « 11 ».
Arrêt 1 : réseauselectNon
Arrêt 1 : numéro d’arrêt ou code de garestringNon
Arrêt 1 : lignes (facultatif)stringNon
Arrêt 2 : réseauselectNon
Arrêt 2 : numéro d’arrêt ou code de garestringNon
Arrêt 2 : lignes (facultatif)stringNon
Arrêt 3 : réseauselectNon
Arrêt 3 : numéro d’arrêt ou code de garestringNon
Arrêt 3 : lignes (facultatif)stringNon
Arrêt 4 : réseauselectNon
Arrêt 4 : numéro d’arrêt ou code de garestringNon
Arrêt 4 : lignes (facultatif)stringNon
OptionssectionNonLes flux sont lus à chaque intervalle (une requête par réseau, quel que soit le nombre d’arrêts), les avis toutes les 5 minutes au plus.
Langue des valeursselectNonLangue des noms de fonctionnalités, des textes publiés et des avis quand exo donne les deux.
Intervalle de lecture (secondes)numberNon
Passages pris en compte jusqu’à (minutes)numberNon
Lire les avis de servicebooleanNonAjoute le nombre d’avis actifs de l’arrêt et le texte du principal.

Comment installer exo dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : exo 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/lm1lc3n7/gladys-exo:0.1.1), 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/LM1LC3N7/gladys-exo.

exo nécessite Gladys >=5.3.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​

exo 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 LM1LC3N7, et non par l'équipe cœur de Gladys.

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 🙂