ParkMyCar / MMM-nyc-transit

MTA transit module for Magic Mirror

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

MTA transit module for Magic Mirror

πŸ›‘Badges

follow on Twitte GitHub followers

GitHub tag (latest SemVer) All Contributors GitHub top language GitHub GitHub issues GitHub issuesGitHub pull requests GitHub closed pull requests

ℹ️ 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.git
  2. install all the npm modules with either yarn install or npm install
  3. update your Magic Mirror 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

βš–οΈ License

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

πŸ™πŸ½ Acknowledgments

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Elan Trybuch

🎨 πŸ’» πŸ‘€ πŸ“– 🚧 πŸš‡

Eric Lewis

πŸ’»

Kendiggity973

πŸ€” πŸ›

dahlio

πŸ€” πŸ›

jon7187

πŸ› πŸ€” πŸ’‘

nipper2000h

πŸ›

Kurt Raschke

πŸ› πŸ’»

Julian Graham

πŸ› πŸ’»

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

About

MTA transit module for Magic Mirror

License:MIT License


Languages

Language:JavaScript 88.2%Language:CSS 8.8%Language:HTML 3.0%