README.md

🚏VVO

This is a list of API endpoints, libraries, apps, tools and anything else that's available to access data in the Verkehrsverbund Oberelbe network. This includes the Dresdner Verkehrsbetriebe.

This document is inspired by derhuerst/vbb-modules.

Got any more info, details, links? Please don't hesitate to open an issue and/or PR 🙃

Static Data

• stations.csv - A list of all stations including coordinates.
• stations.json - Same as above, but as GeoJSON.
• VVO_STOPS.JSON - daily updated list of all VVO stations.
• kuerzel_dresden.csv - A list of station abbreviations in Dresden
• kuerzel_umland.csv - A list of station abbreviations around Dresden

APIs

• Widgets
  • For the VVO widgets
  • No known official documentation
  • See documentation/widgets for reverse-engineered docs
• WebAPI
  • New API used by the mobile page (and therefore the official app)
  • No known official documentation
  • See documentation/webapi for reverse-engineered docs
• EFA
  • "Classic" interface for trip requests
  • No known (public) documentation (yet?)
• Trias or here
  • Brand new and still in the process of being implemented afaik
  • "Documentation" v1.1 or v1.2
• DVB WebDFI
  • Closed access
  • For web-based departure monitors
  • See #3 for some more information
  • No known (public) documentation (yet?)
• DVB Maps App
  • POI search and reverse geocoding
  • No known (public) documentation (yet?)

Libraries

Client libraries for various languages, sorted in no particular order. Although the names are specific to the DVB, most if not all of them are compatible with everything in the VVO network.

• Node.js: dvbjs
• Python: dvbpy
• Haskell: dresdner-verkehrsbetriebe
• Swift: DVB
• Java: jVVO
• Ruby: dvbrb
• Go: dvbgo
• Rust: dvb-rs

To make it more obvious which lib support which features, here's a nifty table.

	JavaScript	Python	Haskell	Swift	Java	Ruby	Go	Rust
Find stops via name	✅	✅		✅	✅	✅		✅
Find stops via coords	✅	✅		✅	✅
Departure Monitor	✅	✅	✅	✅	✅	✅	✅	✅
Routing	✅	✅	✅	✅	✅
Reverse Geocoding	✅	✅		✅
POI Search	✅	✅
Route Changes				✅	✅
Supported Lines				✅	✅
Route Map Location
Used API	A, E, D	W, E, D	W, E	A	A	W	W	W

W: Widgets, E: EFA, A: WebAPI, D: DVBApps

Other

• TripKit/VVOProvider - Part of TripKit, a Swift port of schildbach/public-transport-enabler for the iOS app ÖPNV Navigator

Apps

Mobile apps known and used in Dresden.

• DVB mobil - Official, cross-platform
• Faplino - Android
• FahrInfo Dresden - cross-platform
• Öffi - Android
• DVB-Verspaetungen - Android app informing you about the current delay situation
• Manni - iOS
• ÖPNV Navigator - iOS, not specific to the VVO network

Tools, UIs & Experiments

• Home Assistant Integration - Show current departure data for selected stop on Home Assistant Dashboard
• Magic Mirror - Shows current departure data (using dvbpy)
• alfred_dvb - Alfred workflow for departure data (using dvbgo)
• Amazon Echo - Tweet @ubahnverleih for more info
• catch-my-bus - ruby script notifying you about your next bus
• catch-my-bus-python - GTK3 StatusIcon showing current departure data
• DVBot - DVB Facebook Messenger Bot
• ddplan - Electron based station monitor that lives in the menubar
• Abfahrtsmonitor - Departure board for your Apple Watch
• hubot-dvb - Hubot script (using dvbjs)
• dresden-departure-monitor - Bashscript for getting current departure times
• AbfahrtsTV - Current departure times on your AppleTV, 'cause why not
• DVBManniBot - Telegram bot for checking current departures
• Verkehrsbot - another Telegram bot for checking current departures (using dvbpy)
• Dresden Bot - Feature rich Telegram bot with routing, maps, departures and a lot more
• dvb-on-esp32 - Current depature times on lcd via ESP32 (Arduino)
• dvb-browser - Vue.js (mobile) browser app showing real time departures really fast
• oepnvdresdenbot - Telegram bot featuring natural language queries for departures and routes
• ARKit Abfahrtsmonitor - iOS ARKit demo showing departure information
• Departure Shortcut - Shortcut for iOS' Shortcuts app showing departures
• dvb-mqtt - Periodically publish departure data to an mqtt broker
• dvblive - Visualization of tram delays for the entire city (live demo - #odcdresden19 project)
• VV...Wo? - iOS app using natural language queries (#odcdresden19 project)
• DVBFast - WebApp that displays the departure infos of the nearest stations using GPS (live Version)
• MMM-DVB - MagicMirror² module