is-there-tgv-max

Simple script to get an email with all the TGV Max Train available on a specific day.

UPDATE: This project is not maintained anymore. However, feel free to fork this repository and to update the script with the new API URL from SNCF, which looks like this: https://www.maxjeune-tgvinoui.sncf/api/public/refdata/search-freeplaces-proposals?destination=FRPNO&origin=FRADJ&departureDateTime=2025-06-21T00:00:00.000Z

To get these information, I'm using here the request from the official website of SNCF (oui.sncf).

Installation

The mail delivery system used here is SendGrid. You will need to go on their website and get an API key.

Moreover, you will need Python3 and two modules called SendGrid-Python and Requests.

pip3 install sendgrid
pip3 install requests

You will also need to set three environments variables

EMAIL_FROM="john.doe@example.com" # The address from which the email will be sent
EMAIL_TO="john.doe@example.com" # The address which will receive the email
SENDGRID_API_KEY="SG..." # The API key coming from your account on Send Grid.

Usage

The script must be executed like this:

./script.py <RRCODE CITY FROM (FRPAR, FRLIL, etc.)> <RRCODE CITY TO> <DATE (YYYY-mm-DD)>

The RRCODE are identifiers which are unique for a station or a city. You can find a complete list here. Even though you precise a specific station, the API will give all the trips in the city or around.

The DATE must be in the following format 2018-12-05.

Feedback

Feel free to create an issue if you have any remark or problem.