Intégration domotique Belgian Mobility, gratuite et open source
Départs en direct, retards et perturbations : SNCB, STIB, De Lijn et TEC dans toute la Belgique.
Publiée par gboulvin
- Appareils
- Version 1.0.0
- Nécessite Gladys >=5.1.0
- ★ 0
Suivez depuis Gladys les transports en commun que vous utilisez, partout en Belgique : les prochains départs de votre gare et de vos arrêts de métro, tram ou bus, leurs retards et suppressions, et les perturbations du réseau SNCB.
| Opérateur | Couvre | Source |
|---|---|---|
| SNCB / NMBS | Trains (voies, retards, suppressions) | iRail |
| STIB / MIVB | Métro, trams et bus bruxellois | Transitous |
| De Lijn | Trams et bus flamands | Transitous |
| TEC | Métro (Charleroi), trams et bus wallons | Transitous |
Les deux sources sont gratuites et ouvertes : pas de compte, pas de clé d'API. L'intégration a besoin d'une connexion internet (cloud).
1. Trouver vos arrêts
- Une gare : tapez simplement son nom, dans n'importe quelle langue
officielle :
Namur,Bruxelles-CentralouBrussel-Centraal,Liège-Guillemins. - Un arrêt de métro, tram ou bus : dans l'écran de configuration, cliquez
sur Rechercher un arrêt, tapez son nom (
De Brouckère,Gent Korenmarkt,Charleroi Palais...) et copiez l'identifiant affiché après la flèche, par exemplebe-stib_6.
2. Configurer
| Champ | Rôle |
|---|---|
| Arrêts à suivre | Les arrêts, séparés par ;. Ajoutez | 71, 89 après un arrêt pour ne garder que ces lignes (IC, S... en train). |
| Langue des textes | Anglais, français, allemand ou espagnol : résumés, sorties de scène, noms de gares SNCB et perturbations. |
| Alerte de retard | Un départ en retard d'au moins ce nombre de minutes déclenche Départ en retard (5 par défaut). |
| Temps pour partir | Départ imminent se déclenche quand un départ est à ce nombre de minutes (10 par défaut, 0 le désactive). |
| Réseau SNCB | Ajoute l'appareil Réseau SNCB et le déclencheur Nouvelle perturbation SNCB. |
| Intervalle | Fréquence de lecture de chaque arrêt, en secondes (60 minimum). |
Exemple : Namur; be-stib_6 | 1, 5; Bruxelles-Central | IC
Enregistrez, puis ouvrez l'onglet Découverte de l'intégration pour créer les appareils. Le bouton Tester la connexion vérifie que les deux sources répondent.
3. Appareils
Chaque arrêt suivi devient un appareil à trois fonctionnalités :
- Prochain départ dans : minutes avant le prochain départ que vous pouvez prendre ;
- Retard du prochain départ : en minutes, avec historique ;
- Prochain départ : un résumé, par exemple
14:47 S61 4586 → Wavre, Voie 5.
L'appareil optionnel Réseau SNCB affiche la dernière perturbation.
4. Scènes
Déclencheurs (chacun se déclenche une fois par trajet, jamais à chaque rafraîchissement) :
- Départ en retard, Départ supprimé, Départ imminent : filtrez sur
un arrêt, une ligne (
71,IC) ou un train précis (IC 2113). Les actions suivantes peuvent utiliserline,vehicle,destination,delay_minutes,minutes,platform,scheduled_time,expected_time... - Nouvelle perturbation SNCB : une perturbation ou des travaux sur le réseau ferroviaire.
Actions :
- Obtenir le prochain départ d'un arrêt (éventuellement d'une ligne ou dans une direction) ;
- Planifier un trajet en train entre deux gares, maintenant ou à une heure donnée ;
- Obtenir l'état du réseau SNCB.
Exemple : chaque jour de semaine à 7h15, obtenir le prochain départ de Namur
en direction de Bruxelles ; si delay_minutes > 5, m'envoyer « Ton
{{vehicle}} a {{delay_minutes}} min de retard, voie {{platform}} ».
5. Widgets du tableau de bord
- Tableau des départs : les prochains départs d'un arrêt (choisi dans les réglages du widget) avec retards, suppressions et voies, et un bouton d'actualisation ;
- Réseau SNCB : perturbations en cours et travaux prévus.
Bon à savoir
- Le temps réel dépend de l'opérateur : la SNCB, De Lijn et le TEC le publient ; les arrêts STIB affichent pour l'instant l'horaire théorique (badge Théorique).
- Seuls les identifiants d'arrêts et noms de gares que vous configurez sont envoyés à iRail et Transitous. Rien d'autre ne quitte votre Gladys.
- Un arrêt signalé comme inconnu dans l'état de connexion : vérifiez l'orthographe ou utilisez Rechercher un arrêt.
Paramètres de configuration
Voici les paramètres demandés par Belgian Mobility dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Pour commencer | section | Non | Suivez les gares et les arrêts de métro, tram et bus que vous utilisez, partout en Belgique. Les données viennent de deux API ouvertes et gratuites, sans compte ni clé : iRail pour les trains SNCB, Transitous pour la STIB, De Lijn et le TEC. Le bouton « Rechercher un arrêt » ci-dessous donne l'identifiant d'un arrêt. |
| Arrêts à suivre | string | Non | Séparés par « ; ». Un nom de gare SNCB (Namur) ou un identifiant donné par « Rechercher un arrêt » (be-stib_6). Ajoutez « | 71, 89 » pour ne garder que certaines lignes. |
| Langue des textes | select | Non | Langue des résumés, des sorties de scène, des noms de gares SNCB et des perturbations. |
| Alerte de retard (minutes) | number | Non | Un départ en retard d'au moins ce nombre de minutes déclenche « Départ en retard » dans les scènes. |
| Temps pour partir (minutes) | number | Non | « Départ imminent » se déclenche quand un départ est à ce nombre de minutes (le temps de rejoindre l'arrêt). 0 le désactive. |
| Suivre les perturbations du réseau SNCB | boolean | Non | Ajoute un appareil « Réseau SNCB » et le déclencheur de scène « Nouvelle perturbation ». |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de lecture de chaque arrêt, en secondes (une minute minimum). |
Comment installer Belgian Mobility dans Gladys
- Dans Gladys, ouvrez Intégrations : Belgian Mobility apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/gboulvin/gladys-belgianmobility: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). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/gboulvin/Gladys-BelgianMobility.
Belgian Mobility 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
Belgian Mobility 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 gboulvin, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation