MagicMirror² v2.14.0 is available! For more information about this release, check out this topic.

MMM-MBTA - Information about a single MBTA (Boston, Massachusetts) station

  • Module Developer

    Hey all,
    I made a module to show information about a single MBTA (subway, bus, etc.) station in Boston. When you get dressed, you’ll be able to see the upcoming trains, and when to leave.


    You can choose a station, various options (e.g. eta time, arrival time, neither, both) and it’ll show options like alerts, if you put it on a full-width position. You can also filter out types of transportation and cap the number of shown. Other options include formatting your eta time (seconds only, minutes only, or minutes and seconds) and showing the full name rather than the short-hand. I’ve even attempted to match the formatting of the default modules, for better looking integration.

    The data was taken from the MBTA api, so this is only as accurate as their stuff :^). Note that their API limits a single type of request to 1 per 10 seconds, so unfortunately I can’t implement more than one station.

    I would love to hear your feedback and suggestions (please make an issue on github; I’m on there more often!). I’m new to the developer scene, so any and all are appreciated!

  • Hey Edward,

    Does the new mbta api-v3 affect anything with this module? My mirror recently stopped pulling bus data and I’m wondering if it’s because I’m currently using an api-v2 key.

    / jamie

  • Module Developer

    Yup, since APIv2 will no longer function after March or April, the repo has been updated to use the new APIv3. Unfortunately, you’ll need a new key, but it doesn’t require a wait to get a new key.

    We’ve also changed a little bit on the config side. If your MMM-MBTA doesn’t work after using APIv3, check if to see if the station name has changed. There’s a list on the repo. We also have new config options, so check that out as well!

    If that still doesnt fix it, make an issue on GitHub or privately email me, I’ll be happy to help.

  • First off, thanks for making a great module! I may be missing something in setting it up, but how do you specify between two bus stations with the same name but are going in different directions? For example, in the stations-formatted file Washington St @ Massachusetts Ave only displays one direction, how would I get it to display the opposite? I see the different station numbers 5 vs 55 but using those just shows no vehicles scheduled. Is it possible? Thanks!

  • Module Developer

    Hey @wimosaur, sorry for the late response.

    As far as I can remember, I never really implemented support for specifying which direction to use. Due to the lack of support/demand I haven’t really been updating/working on this module.

    If you need the other direction, I’ve made a quick update to MMM-MBTA that lets you specify which direction for that station only. Specify "Washington St @ Massachusetts Ave 1" for one direction "Washington St @ Massachusetts Ave 2" for the other direction.

    Unfortunately, MMM-pages seems to be both more popular and has a large bug in it that’s driving me insane, so I don’t think I can add new functionality to this module in the future.

    That being said, I’m always happy for people to make PRs, and I’ll be happy to merge code in!

  • Module Developer


    For all future issues, please create an issue on Github! I do not monitor the Magic Mirror forums!