MMM-PublicTransportBerlin

MMM-PublicTransportBerlin is a module for the MagicMirror project by Michael Teeuw.

It shows live public transport information for Berlin and Brandenburg based on BVG-Hafas data. Public transport in Brandenburg should work as well.

MMM-PublicTransportBerlin uses the hafas-client with a BVG-specific profile by derhuerst.

You can enter a delay time for "How long does it take to get to my station?". Then the module calculates the next reachable departures and draws a line between reachable and unreachable departures.

Status

The current development status of this module is: maintained This means: I'm open for feature requests, pull requests, bug reports, ...

Screenshot

The module looks like this:

Preconditions

• MagicMirror² instance
• Node.js version >= 12
• npm

Installation

Just clone the module into your MagicMirror modules folder and execute npm install in the module's directory:

git clone https://github.com/deg0nz/MMM-PublicTransportBerlin.git
cd MMM-PublicTransportBerlin
npm install

Update

Just enter your MMM-PublicTransportBerlin folder in the MagicMirror's modules folder and execute the following commands in the module's directory:

git pull
npm install

How to get the stationId

You will need a stationId for your module. You can get it as described in the BVG-rest API documentation. This is a cURL example for getting all possible stations with the keyword "alexanderplatz":

curl 'https://v5.bvg.transport.rest/locations?query=alexanderplatz'

The answer should contain one or more possible stations with valid station IDs. More queries are possible, like searching via coordinates or autocompletion of stations. Please check the BVG-rest API documentation for more options. Please note, that you need to query 1.bvg.transport.rest.

You can prettify the JSON output with jq if you have it installed:

curl 'https://v5.bvg.transport.rest/locations?query=alexanderplatz' | jq

Configuration

The module quite configurable. These are the possible options:

Here is an example of an entry in config.js:

{
    module: "MMM-PublicTransportBerlin",
    position: "top_right",
    config: {
        name: "Alexanderplatz",
        stationId: "900000100003",
        hidden: false,
        ignoredLines: ["U5", "U8", "S75", "Bus 100"],
        excludedTransportationTypes: "bus,suburban,subway",
        travelTimeToStation: 10,
        interval: 120000,
        departureMinutes: 10,
        marqueeLongDirections: true,
        showColoredLineSymbols: true,
        useColorForRealtimeInfo: true,
        showTableHeaders: true,
        showTableHeadersAsSymbols: true,
        maxUnreachableDepartures: 3,
        maxReachableDepartures: 7,
        fadeUnreachableDepartures: true,
        fadeReachableDepartures: true,
        fadePointForReachableDepartures: 0.25,
        excludeDelayFromTimeLabel: true,
        useBrightScheme: true
    }
},

Multiple Modules

Multiple instances of this module are possible. Just add another entry of the MMM-PublicTransportBerlin module to the config.js of your mirror.

Special Thanks

• Michael Teeuw for inspiring me and many others to build a MagicMirror.
• Jannis Redmann for creating the hafas-client. You made my life a lot easier with this! Please consider supporting him on Patreon!
• The community of magicmirror.builders for help in the development process and all contributors for finding and fixing errors in this module.

Issues

If you find any problems, bugs or have questions, please open a GitHub issue in this repository.