Berlin (BVG) and Brandenburg (VBB) transport widget for Home Assistant

Custom integration that displays upcoming departures from your defined public transport stops for Berlin and Brandenburg.

This repository contains only the integration, the Lovelace card itself lives here: https://github.com/vas3k/lovelace-berlin-transport-card

You need to install them both. Preferably through HACS. We have separated two repositories to make installation through it more convenient.

I use iOS Dark Mode Theme by @basnijholt, installed from HACS

• Home Assistant 2025.3.0 or newer. The integration uses config subentries, which were introduced in that release.
• Access to a vbb-rest API server. By default the public instance at https://v6.vbb.transport.rest is used, but you can point the integration at your own — see Using your own API server.

The component consists of two parts:

1. A sensor, which tracks departures via the VBB public API every 90 seconds. This is this repository.
2. A widget (card) for the Lovelace dashboard, which displays upcoming transport in a nice way. It has its own separate repository with installation instructions.

Add this repository as a custom repository in HACS in the category "integration", install it, and restart Home Assistant.

The integration is organised as a hub with one stop per subentry. The hub holds the API settings; each stop under it is a sensor entity. This means you configure the API endpoint once and add as many stops as you like underneath it.

Go to Settings → Devices & services → Add integration and search for Berlin (BVG) and Brandenburg (VBB) transport. You will be asked for:

If you just want the public API, accept the defaults.

On the integration's page, click Add stop. Then:

1. Search for your stop by name. Partial matches work — up to "maximum results" stops will be listed.
2. Select the stop you want to monitor from the dropdown.
3. Optionally configure the per-stop settings below.

Repeat for every stop you want. All stops under one hub share the same API endpoint and request settings.

• Hub settings (API endpoint, maximum results, fallback time): open the hub's ⋮ menu and choose Configure.
• Stop settings: open the stop's ⋮ menu and choose Reconfigure. The stop itself cannot be changed — to monitor a different stop, add a new one and delete the old.

Both take effect immediately; the integration reloads itself.

The public instance at v6.vbb.transport.rest is shared and occasionally rate limited or unavailable (see #36). If you depend on it, run your own copy of derhuerst/vbb-rest — for example with Docker — and set the API endpoint on the hub to your instance, e.g. http://vbb-rest.local:3000.

A home assistant addon for the server is also available at https://github.com/Cornelicorn/homeassistant-addons.

Older versions created one config entry per stop. On first start after the update, each of those entries is migrated automatically into its own hub with a single stop underneath it. Your entities keep their IDs, so history and dashboards are unaffected.

If you had several stops, you will end up with several hubs, each named after the stop it was migrated from. That works fine, but if you want them grouped under one hub with one API config:

1. Add a new hub with your preferred API settings.
2. Add your stops to it.
3. Delete the migrated single-stop hubs.

Note that entities added this way get new IDs, so you will lose their history. Renaming the new entities to the old entity IDs before deleting the old hubs should avoid that.

Downgrading to a pre-hub version is not supported; the config entries cannot be converted back.

YAML setup still works for existing configurations, but it does not support the API endpoint, maximum results, or fallback time settings — those always use the defaults. New setups should use the UI.

sensor:
  - platform: berlin_transport
    departures:
      - name: "S+U Schönhauser Allee" # free-form name, only for display purposes
        stop_id: 900110001 # actual Stop ID for the API
        # direction: 900110002,900007102 # Optional stop_id to limit departures for a specific direction (same URL as to find the stop_id), multiple Values can be specified using a comma separated list
        # excluded_lines: S41 # Optional comma separated list of line names to exclude
        # walking_time: 5 # Optional parameter with value in minutes that hides transport closer than N minutes
        # suburban: false # Optionally hide transport options
        # show_official_line_colors: true # Optionally enable official VBB line colors. By default predefined colors will be used.
        # duration: 30 # Optional (default 10), query departures for how many minutes from now?
      - name: "Stargarder Str." # currently you have to add more than one stop to track
        stop_id: 900000110501
        # direction: 900000100002 # Optional stop_id to limit departures for a specific direction (same URL as to find the stop_id), multiple Values can be specified using a comma separated list
        # excluded_stops: 900110502,900007102 # Exclude these stop IDs from the departures, duplicate departures may be shown for nearby stations
        # walking_time: 5 # Optional parameter with value in minutes that hide transport closer than N minutes
        # show_official_line_colors: true # Optionally enable official VBB line colors. By default predefined colors will be used.
        # duration: 30 # Optional (default 10), query departures for how many minutes from now?

To install manually, copy the whole berlin_transport directory into the custom_components folder of your Home Assistant installation (create it next to configuration.yaml if it doesn't exist), then restart Home Assistant.

The UI flow searches for stops for you, so you only need this for YAML, or for the direction and exclusion filters.

Use this URL: https://v6.vbb.transport.rest/locations?results=1&query=alexanderplatz

Replace alexanderplatz with the name of your own stop. If you self-host, use your own server's address instead.

🧐 Pro tip: You can also use the location-based API to find all stops nearby using your GPS coordinates.

Go to the lovelace-berlin-transport-card repo and follow the installation instructions there.

This sensor uses the VBB public API to fetch all transport information.

• API docs: https://v6.vbb.transport.rest/api.html
• Rate limit on the public instance: 100 req/min
• Format: HAFAS

Every stop is polled every 90 seconds, and each stop is a separate request. If you filter by direction, one request is made per direction. On the public API, keep that in mind before adding dozens of stops so you don't hit the rate limit.

The public API is a bit unstable (as you can guess), so sometimes it returns random 503 or timeout errors. This is normal. When a request fails, the last known departures are kept for the configured fallback time and stale ones are dropped as they pass; after that the sensor goes unavailable.

Each stop becomes one entity, with the upcoming departures written into attributes.departures (as many as the hub's "maximum results" setting). The entity state is not really used anywhere, it just shows the next departure in a human-readable format. If you have any ideas how to use it better — welcome to GitHub Issues.

🤔 In principle, the HAFAS format is standardized in many other cities too, so you should have no problem adapting this component to more places if you wish. Check out transport.rest for inspiration.

Contributions are welcome. Feel free to open a PR and send it for review. If you are unsure, open an Issue and ask for advice.

This is a hobby project, so we cannot guarantee 100% support or help with configuring your dashboards. We hope for your understanding.

• If you find a bug, open an Issue and describe the exact steps to reproduce it. Attach screenshots, copy all logs and other details to help find the problem. Please mention whether you use the public API or your own server.
• If you're missing a certain feature, describe it in Issues and try to code it yourself. It's not hard. At the very least, you can try to bribe @vas3k with a PayPal donation :)

• MIT