SNCF Smart-Home-Integration, kostenlos und Open Source
Your SNCF trains in real time: delays, cancellations, scenes, widgets.
Veröffentlicht von William-De71
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.1
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
This integration follows your SNCF trains in real time in Gladys: the next departures of your trips (home → work, the way back…), their delays, the cancellations and their cause. It turns them into devices, scene triggers ("my train is cancelled", "my train leaves in 15 minutes") and dashboard widgets.
The data comes from the official SNCF API: real time for TGV INOUI, OUIGO, Intercités, TER, Lyria and Eurostar. Transilien trains are timetable only (no delays, no cancellations).
Community integration, not affiliated with or endorsed by SNCF.
Configuration
1. Get an API key (free)
- Open the SNCF developer token page.
- Fill in your first name, last name and email, accept the terms of use.
- The key (a 36-character identifier, like
0f1e2d3c-4b5a-…) arrives by email.
The free key allows 5 000 requests a day. The integration counts them itself and slows down before the limit: past it, the SNCF blocks the key for hours.
2. Fill in the integration
| Field | Role |
|---|---|
| API key | required |
| Trip 1, 2, 3 | departure and arrival stations (only direct trains are followed) |
| Travel window | optional, e.g. 07:00-09:30: the trains leaving in that window |
| Travel days | optional, e.g. Monday to Friday (empty: every day) |
| Trains followed | how many next trains per trip (4 by default) |
| Delay threshold | from how many minutes a train counts as "delayed" (5 by default) |
| Refresh | every 3 minutes around the window, every 30 minutes the rest of the time (by default) |
For a station, type:
- its name: "Rennes", "Lyon Part Dieu", "Paris Montparnasse" — the first result of the SNCF search is kept;
- its UIC code: "87471003";
- its identifier: "stop_area:SNCF:87471003".
When the name does not give the right station, use the Find a station button: it lists the matching stations with their identifier, to copy into the trip field.
Save, then click Test the connection: for each trip, it tells how many trains were found and the time of the next one.
The travel window
With a travel window, the integration follows the trains of the next window: today's while it is not over, then the next travel day's. In the evening, the widget already shows tomorrow morning's trains, and a cancellation announced the evening before fires your scene the evening before.
It also reads the API often only around the window (from an hour before to its end), which saves the quota: about 250 requests a day for a trip with a 2.5-hour window, 800 without a window.
3. Add the devices
In the Discovery tab, each trip shows up as a device "SNCF – from → to". Add it and put it in a room. Widgets and scenes also work without the device, but choosing the trip in their settings goes through the device list.
| Feature | Value |
|---|---|
| Next train | text, e.g. "07:42 · TER 858311 · +5 min" or "… · cancelled" |
| Delay of the next train | in minutes, the one of the next train that runs (0 when on time) |
| Disrupted trains | how many followed trains are late (from the threshold) or cancelled |
Scenes
Triggers
| Trigger | When | Filters |
|---|---|---|
| SNCF: train delayed | a followed train becomes late (from the threshold), then again past 15 and 30 minutes | trip, delay level |
| SNCF: train cancelled | a followed train is cancelled, or no longer stops at a station of the trip | trip |
| SNCF: train leaving soon | a followed train leaves in 5, 10, 15, 20, 30, 45 or 60 minutes | trip, minutes |
Leaving soon counts on the real-time departure: when your 7:42 train is 5 minutes late, "leaves in 15 minutes" comes at 7:32, not 7:27.
Every trigger provides variables: trip, train number and type, direction, date, scheduled and expected times, delay, cause, and a summary ready to send. Each event fires once per train, even after a restart of the integration.
Action
SNCF: next trains gives the next train of a trip (times, delay, status, cause, minutes until departure, number of disrupted trains) and a sentence summarizing the following ones.
Widgets
| Widget | Content |
|---|---|
| SNCF trip | the next departure time and the time left, then each train with an on time / +N min / cancelled badge; tap a disrupted train to read the cause |
| SNCF departures | the departures board of a station, every direction: a station typed in the widget settings, or the departure station of a trip |
Limits
- Only direct trains are followed (no change).
- Transilien: timetable only, no delays and no cancellations (a limit of the SNCF API).
- The platform is not provided by the official API.
- A cancelled train vanishes from the real-time data of the SNCF: the integration finds it by comparing with the timetable, then confirms it on the departures board of the station. When it cannot be confirmed, the train stays shown as scheduled rather than wrongly announced as cancelled.
Troubleshooting
| Message | What to do |
|---|---|
| "The SNCF API key is refused" | check the key copied from the email (no space) |
| "Station not found: …" | use the Find a station button and copy the identifier it gives |
| "Daily quota of the SNCF API reached" | the SNCF blocked the key until the time shown: fewer trips without a window, or longer intervals |
| "No train found in the followed period" | no direct train in the travel window: check the stations and the window, or empty it |
Konfigurationseinstellungen
Diese Einstellungen fragt SNCF in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| SNCF API key | section | Nein | The trains come from the official SNCF API: TER, TGV INOUI, OUIGO, Intercités, Lyria, Eurostar… in real time (Transilien: timetable only, no delays). The key is free: fill in the form of the SNCF developer page, the key arrives by email. It allows 5 000 requests a day; the integration counts them and slows down before the limit. |
| API key | secret | Ja | The key received by email (a UUID, 36 characters). |
| Trip 1 | section | Nein | A station name ("Rennes", "Lyon Part Dieu"), its UIC code ("87471003") or the identifier given by the "Find a station" button ("stop_area:SNCF:87471003"). Only direct trains are followed. The travel window and days are optional: with them, the trains of the next window are followed and the API is read often only around it (it saves the daily quota). |
| Departure station | string | Nein | |
| Arrival station | string | Nein | |
| Travel window | string | Nein | Departures between these times, e.g. 07:00-09:30. Empty: the next trains, all day. |
| Travel days | multi_select | Nein | Empty: every day. |
| Trip 2 (optional) | section | Nein | Same fields as trip 1, for example the way back. Leave empty when unused. |
| Departure station | string | Nein | |
| Arrival station | string | Nein | |
| Travel window | string | Nein | Departures between these times, e.g. 07:00-09:30. Empty: the next trains, all day. |
| Travel days | multi_select | Nein | Empty: every day. |
| Trip 3 (optional) | section | Nein | Same fields as trip 1, for example the way back. Leave empty when unused. |
| Departure station | string | Nein | |
| Arrival station | string | Nein | |
| Travel window | string | Nein | Departures between these times, e.g. 07:00-09:30. Empty: the next trains, all day. |
| Travel days | multi_select | Nein | Empty: every day. |
| Settings | section | Nein | With a travel window, a trip costs about 250 requests a day with the default values; without one, about 800. Three trips and an open departures board stay within the 5 000 a day. |
| Trains followed per trip | number | Nein | The next trains of each trip, between 1 and 8. |
| Delay threshold (min) | number | Nein | From how many minutes a train counts as delayed (scenes, disrupted trains, colors). |
| Refresh around the window (min) | number | Nein | From an hour before the travel window to its end (all day without a window), between 2 and 30 minutes. |
| Refresh the rest of the time (min) | number | Nein | Outside the window (and at night), between 10 and 180 minutes. |
So installierst du SNCF in Gladys
- Öffne in Gladys Integrationen: SNCF erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/william-de71/gladys-sncf:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/William-De71/gladys-sncf.
SNCF benötigt Gladys >=5.1.1. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
SNCF ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von William-De71 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle externen Integrationen durchsuchen
- Die nativen Integrationen entdecken, die in Gladys eingebaut sind
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation