MMM-Trafiklab

A MagicMirror² module that shows upcoming bus/tram/train arrivals and/or departures for a stop in Sweden, using the Trafiklab Realtime API. Layout inspired by MMM-Futar.

Choose arrivals, departures, or both (two sections in one panel) with the type option. Each row shows the line (with a mode icon, colored by transport mode), the direction, the platform letter, the minutes until arrival, and — when the vehicle is off schedule — the timetable time and the delay (+2 late, −1 early). Canceled trips are struck through.

Vertical layout (side columns):

Horizontal layout (top_bar / bottom_bar):

cd ~/MagicMirror/modules
git clone https://github.com/damithsj/MMM-Trafiklab.git

No npm install is needed (uses Node's built-in fetch, Node 18+).

1. Create a free account at the Trafiklab developer portal.
2. Create a project and add the Trafiklab Realtime APIs to it.
3. Generate an API key for the project and copy it into apiKey in your module config.

Trafiklab's Bronze level allows 25 requests per minute and 100,000 requests per 30 days. Keep that in mind when choosing updateInterval and type (see Request volume). The portal's steps may change over time; see the Trafiklab documentation for the current process.

Use the Stop Lookup endpoint to search for a stop by name:

https://realtime-api.trafiklab.se/v1/stops/name/{searchValue}?key=YOUR_API_KEY

Example for Bygdegatan:

{
  "stop_groups": [
    {
      "id": "740056501",
      "name": "Bygdegatan",
      "transport_modes": ["BUS"],
      "stops": [{ "id": "16629", "name": "Bygdegatan" }]
    }
  ]
}

• Use the stop group id (740056501) as stopId.
• For destinationId, use the short stops[].id of the destination stop instead (for example 9 for Linköping Centralstation, which belongs to group 740000009). This is the id the arrivals and departures data reports for a route's final destination.

Results are sorted by traffic, so the busiest matching stops come first. Remember to URL-encode special characters such as ö (Link%C3%B6ping).

{
  module: "MMM-Trafiklab",
  position: "top_right",
  config: {
    apiKey: "YOUR_API_KEY",   // required
    stopId: "740056501",      // required
    destinationId: "9"        // optional
  }
}

Show both arrivals and departures in a bottom bar:

{
  module: "MMM-Trafiklab",
  position: "bottom_bar",
  config: {
    apiKey: "YOUR_API_KEY",
    stopId: "740056501",
    type: "both",
    layout: "horizontal"
  }
}

The module is translated to English and Swedish following the MagicMirror language setting.

Each update makes one API request (two with type: "both"). The countdown redraws every refreshInterval without calling the API.

Restarts, reloads and extra module instances using the same key add to these numbers.

These are the default badge colors. You can change any of them with modeColors, and any mode you leave out keeps its default.

Mode	Default	Color
BUS	#e10e1c
TRAM	#b90000
METRO	#0a78c8
TRAIN	#ec6fa6
SHIP	#00a3a1
TAXI	#d4a017
UNKNOWN	#808080

modeColors: {
  BUS: "#e10e1c",
  TRAM: "#b90000",
  METRO: "#0a78c8",
  TRAIN: "#ec6fa6",
  SHIP: "#00a3a1",
  TAXI: "#d4a017",
  UNKNOWN: "#808080"
}

MIT