2024.12.5
Home ▸ Integrations ▸

Trenitalia ViaggiaTreno

The Trenitalia ViaggiaTreno integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] will give you information about configured train ids and stations using the public ViaggiaTreno API.

To activate the integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more], you need at least two parameters: the train_id and the station_id.

The first is available just looking at the ViaggiaTreno timetable, the latter can be obtained using the dedicated API endpoint: http://www.viaggiatreno.it/infomobilita/resteasy/viaggiatreno/autocompletaStazione/<Station name> (e.g., http://www.viaggiatreno.it/infomobilita/resteasy/viaggiatreno/autocompletaStazione/ROMA will list all station names (with ids) that starts with ROMA).

Note

The station_id is referred to the train’s departing station. If a train number does not match with the station id, no data will be returned to the sensor.

Then add the data to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file. After changing the configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file, restart Home Assistant to apply the changes. The integration is now shown on the integrations page under Settings > Devices & services. Its entities are listed on the integration card itself and on the Entities tab.

# Example configuration.yaml entry
sensor:
  - platform: viaggiatreno
    train_id: 12279
    station_id: S08409

Configuration Variables

Looking for your configuration file?
train_id integer Required

The ID of the train.

station_id integer Required

The ID of the starting station.

train_name string (Optional)

The name of the sensor. Defaults to ‘Train from ’.

Note

In a future implementation, the station name could be used to automatically search best-matching station id, without the need to specify it.

The public timetables are coming from ViaggiaTreno.

Note

Instructions (in Italian) for the API are available at: https://github.com/bluviolin/TrainMonitor/wiki/API-del-sistema-Viaggiatreno

Related topics