A MagicMirror² module to show public transport departures on your mirror, with broad international coverage and per-instance provider switching.

This module supports multiple providers in one place (transitous, hafas, vendo), so you can choose the backend that works best for each station.

Compared with earlier public transport modules that were tied to one backend, Transitous gives this module much broader regional coverage out of the box.

Transitous is also a community-driven open-source project, which fits well with the MagicMirror ecosystem.

Providers differ in coverage and data quality per region — no single provider is best everywhere.

• Transitous is a good first choice: it covers most of Europe and many regions worldwide via aggregated open GTFS feeds.
• HAFAS (with the right profile) often provides richer real-time data and better stop matching for specific operators.
• Vendo (db/dbweb) is the strongest choice for Deutsche Bahn long-distance and regional trains within Germany.

Recommendation: test all three providers for your specific station and pick the one that gives the best results locally.

Limitations/trade-offs to keep in mind:

• Providers still differ in line naming, products, and platform semantics.
• Timeout/retry is intentionally simple (fixed backoff, no circuit breaker).
• Reachability currently uses only configured timeToStation and departure timestamps.

Clone this module into your MagicMirror modules directory and install dependencies:

cd ~/MagicMirror/modules
git clone https://github.com/KristjanESPERANTO/MMM-PublicTransportHub
npm ci

To update, pull the latest changes in the module directory:

cd ~/MagicMirror/modules/MMM-PublicTransportHub
git pull
npm ci

    {
      module: "MMM-PublicTransportHub",
      position: "top_left",
      config: {
        provider: "transitous",
        stationId: "de-DELFI_de:11000:900100003",
        contact: "you@example.com",
      },
    },

    {
      module: "MMM-PublicTransportHub",
      position: "top_left",
      header: "S+U Alexanderplatz Bhf",
      config: {
        provider: "transitous",
        stationId: "de-DELFI_de:11000:900100003",
        updatesEvery: 60,
        maxDepartures: 7,
        timeToStation: 4,
        maxUnreachableDepartures: 2,
        excludeCanceled: false,
        lineFilter: ["S", "U2"],
        directionFilter: ["Potsdam", "Alexanderplatz"],
        productFilter: ["subway", "suburban"],
        showDelay: false,
        showRealtimeIndicator: true,
        showRemarks: true,
        lineStylePreset: "none", // plain | none | berlin | duesseldorf | ...
        replaceInLineNames: { "Bus ": "" },
        requestTimeoutMs: 12000,
        fetchRetries: 1,
        // For Transitous, set this to a reachable email address or your MagicMirror forum alias.
        contact: "you@example.com",
      }
    },

Note: legacy option showColoredLineBadges has been replaced by lineStylePreset.

Use the interactive helper to find station IDs and ready-to-copy config snippets:

node --run query

The script asks for a station/location name, then queries Transitous, HAFAS, and Vendo. You can choose to use default profiles (HAFAS: db, Vendo: db) or specify custom ones (comma-separated for multiple profiles per provider).

Example flow:

Enter an address or station name: Leipzig Hbf
Use default profiles (HAFAS: db, Vendo: db)? (y/n): n
Enter HAFAS profile(s) (comma-separated, e.g. 'db,insa,vbb'): insa
Enter Vendo profile(s) (comma-separated, or empty for default): db

The script then queries all providers and prints recommended config blocks ready to copy.

Some parts of this module are inspired by MMM-PublicTransportHafas.

This project is licensed under the MIT License - see the LICENSE file for details.

All notable changes to this project will be documented in the CHANGELOG.md file.