README.md

MTA transit module for MagicMirror²

🛡 Badges

ℹ️ How to use this module

1. clone this repo into your moducles directory with the following command: git clone https://github.com/Elaniobro/MMM-nyc-transit
2. install all the npm modules with either yarn install or npm install
3. update your MagicMirror² Config, by adding the following object:

  {
    module: 'MMM-nyc-transit',
    position: "top_bar",
    header: "Next Train",
    config: {
      apiKey: 'YOUR_KEY_HERE',
      displayType: 'list',
      mtaType: 'train',
      stations: [
        {
          stationId: 237,
          walkingTime: 5,
          dir: {
              upTown: false,
              downTown: true
          }
        },
        {
          stationId: 177,
          walkingTime: 5,
          dir: {
            upTown: true,
            downTown: false
          }
        }
      ],
      updateInterval: 300000
    }
  }

🛠️ Config

• module the name of the module you are installing.
• position where you want the mmm-nyc-transit module to appear.
  • note: configurable, see MM documentation
• header display name for what you want to call your module on screen
  • note: optional
• displayType choose between scrolling marquee (default) or list
  • list - shows next 3 trains for each line, both uptown and downtown
    • note: works best on side
  • marquee - shows next 6 trains, 3 for uptown and 3 for downtown
    • note: works best on top
• apiKey see mta api Key on where to obtain yours.
• mtaType coming soon, choose bus and or train
• stations array to store each station config.
  • stationId find your station(s) id(s).
  • walkingTime allows you to pad the realtime data time, with travel time to the station.
  • dir object to hold which directions of the train to show
    • upTown boolean value
    • downTown boolean value
• updateInterval default is set to 5 minutes
  • low interval will result in your MTA api key timing out

🔑 MTA API Key

You will need to sign up for the MTA Real-Time Data Feeds API. To get a key, please visit their website: api.mta.info.

🚆 Station List

Find the corresponding Name and id in the STATION_LIST.md object to insert into the config array.

✨ Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please open an issue

👨🏻 Author

Elan Trybuch

• github
• twitter

⚖️ License

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

🙏🏽 Acknowledgments

• Eric Lewis

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Elan Trybuch 🎨 💻 👀 📖 🚧 🚇	Eric Lewis 💻	Kendiggity973 🤔 🐛	dahlio 🤔 🐛	jon7187 🐛 🤔 💡	nipper2000h 🐛	Kurt Raschke 🐛 💻
Julian Graham 🐛 💻	Kristjan ESPERANTO 🚧

This project follows the all-contributors specification. Contributions of any kind welcome!