2024.10.4
Home ▸ Integrations ▸

RMV

The rvmtransport integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] will give you the departure time of the next bus, tram, subway or train at the next station or stop in the Rhein-Main area public transport network. Additional details such as the line number and destination are present in the attributes.

Setup

Visit the RMV OpenData web site to find a list of valid station IDs.

Configuration

To enable this integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more], add the following lines 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: rmvtransport
    next_departure:
     - station: STATION_OR_STOP_ID

Configuration Variables

Looking for your configuration file?
timeout integer (Optional, default: 10)

Specify the timeout for the API calls.

next_departure list Required

One or multiple departure sensors.

name string (Optional)

Name to use in the frontend.

Default:

The default is the station name.

station string Required

ID of the stop or station, e.g., 3000010.

destinations string (Optional)

One or multiple final stop names, e.g., ‘Frankfurt (Main) Hauptbahnhof’ or [‘Frankfurt (Main) Hauptbahnhof’,‘Frankfurt (Main) Stadion’]. This can be used to only consider a particular direction of travel.

direction string (Optional)

Name of a stop or station, e.g., ‘Frankfurt (Main) Hauptbahnhof’. This can be used to only consider a particular direction of travel.

lines string | integer (Optional)

One or more line numbers, e.g., 'S8' or ['S8', 'RB33', '41']

products string (Optional)

One or more modes of transport ['U-Bahn', 'Tram', 'Bus', 'S', 'RB', 'RE', 'EC', 'IC', 'ICE'].

Default:

[“U-Bahn”, “Tram”, “Bus”, “S”, “RB”, “RE”, “EC”, “IC”, “ICE”]

time_offset integer (Optional, default: 0)

Do not display departures leaving sooner than this number of minutes. Useful if you are a couple of minutes away from the stop.

max_journeys integer (Optional, default: 5)

Specify the maximal number of journeys.

Examples

Full configuration

The example below shows a full configuration with three sensors that showcase the various configuration options.

# Example configuration.yaml entry
sensor:
  - platform: rmvtransport
    scan_interval: 120
    timeout: 10
    next_departure:
      - station: 3000010
        time_offset: 5
        destinations:
          - 'Frankfurt (Main) Flughafen Regionalbahnhof'
          - 'Frankfurt (Main) Stadion'
        products:
          - 'RB'
          - 'RE'
          - 'Bus'
          - 'S'
      - station: 3006907
        products: "Bus"
        destinations: ['Wiesbaden Dernsches Gelände', 'Mainz Hauptbahnhof']
        name: Destination
      - station: 3006904
        lines: "S8"
        max_journeys: 5
        products: "S"

The first sensor will return S-Bahn, bus, RB and RE trains departures from Frankfurt Hauptbahnhof to Frankfurt Airport or Stadium that are at least 5 minutes away.

The second sensor returns bus departures from Wiesbaden Hauptbahnhof going to Dernsches Gelände and Mainz Hauptbahnhof. To retrieve the time of the second departure, you would use state_attr('sensor.ENTITY_NAME', 'departures')[1].time.

The third sensor returns all S-Bahn trains from Mainz Hauptbahnhof for line S8.

Related topics