openpublictransport
Real-time public transport departures for Home Assistant — 26 providers across Germany, Switzerland, Austria, Sweden, Ireland, and worldwide.
Coming from VRRAPI-HACS or hacs-publictransport?
This is the new official repository! The domain changed from vrr to openpublictransport — entity IDs and services have new names.
→ Migration Guide — Step-by-step instructions for both migrations.
Supported Providers (26)
| Provider | Region | API Type | API Key |
|---|---|---|---|
| AVV | Augsburg | EFA | No |
| BEG | Bavaria | EFA | No |
| BSVG | Braunschweig | EFA | No |
| BVG | Berlin / Brandenburg | FPTF REST | No |
| DB | Germany (nationwide, community API) | FPTF REST | No |
| DING | Ulm / Donau-Iller | EFA | No |
| HVV | Hamburg | EFA | No |
| KVV | Karlsruhe | EFA | No |
| MVV | Munich | EFA | No |
| NTA | Ireland (nationwide) | GTFS-RT | Yes (free) |
| NVBW | Baden-Württemberg | EFA | No |
| NWL | Westfalen-Lippe | EFA | No |
| ÖBB | Austria (nationwide) | FPTF REST | No |
| RMV | Frankfurt / Rhein-Main | HAFAS | Yes (free) |
| RVV | Regensburg | EFA | No |
| SBB | Switzerland (nationwide) | REST | No |
| Trafiklab | Sweden (nationwide) | REST | Yes (free) |
| Transitous | Worldwide (community) | MOTIS2 | No |
| VAG | Freiburg | EFA | No |
| VBN (OTP) | Bremen / Niedersachsen | OTP REST | Yes (free) |
| VBN (TRIAS) | Bremen / Niedersachsen | TRIAS XML | Yes (free) |
| VGN | Nuremberg | EFA | No |
| VRN | Rhein-Neckar | EFA | No |
| VRR | Rhein-Ruhr (NRW) | EFA | No |
| VVO | Dresden | EFA | No |
| VVS | Stuttgart | EFA | No |
Features
Core Features
- Smart Setup Wizard - Intuitive multi-step configuration with autocomplete for locations and stops
- Real-time Departures - Shows current departure times with delays
- Multiple Transport Types - Supports trains (ICE, IC, RE), subway, trams, and buses
- Smart Filtering - Filter by specific transportation types
- Binary Sensor for Delays - Automatic detection of delays > 5 minutes
- Device Support - Entities are grouped together with suggested areas
- Repair Issues Integration - Automatic notifications for API errors or rate limits
- Rate Limiting - Intelligent API rate limiting to prevent overload
- Timezone Support - Proper handling of provider-specific timezones
Intelligence & Performance Features
- Fuzzy Matching with Typo Tolerance - Intelligently finds stops even with typos
- Handles common misspellings: "Hauptbanhof" → "Hauptbahnhof"
- German umlaut normalization: "Dusseldorf" → "Düsseldorf"
- API Response Caching - 5-minute intelligent cache reduces API load
- Optimized Sensor Performance - 20-30% faster departure processing
Quick Start
- Install via HACS (recommended) or manually
- Add the integration via Settings > Devices & Services > Add Integration
- Search for "Public Transport Departures"
- Follow the setup wizard to configure your stops
Transportation Types
The integration supports the following transport types:
| Type | Icon | Description |
|---|---|---|
train |
:material-train: | Trains (ICE, IC, RE, RB) |
subway |
:material-subway-variant: | Subway/Metro (U-Bahn) |
tram |
:material-tram: | Tram/Streetcar |
bus |
:material-bus: | Bus |
ferry |
:material-ferry: | Ferry |
taxi |
:material-taxi: | Taxi |
License
This project is licensed under the MIT License.
Support
For issues or questions:
- Check the Troubleshooting guide
- Search existing GitHub Issues
- Create a new issue with debug information