Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/adammoses-github/mmm-dcmetrotraintimes
A module for the Magic Mirror to display DC metro train arrival times for the various stations as well as any reported incidents.
https://github.com/adammoses-github/mmm-dcmetrotraintimes
dc dmv magicmirror md metro schedule transit va wmata
Last synced: 2 months ago
JSON representation
A module for the Magic Mirror to display DC metro train arrival times for the various stations as well as any reported incidents.
- Host: GitHub
- URL: https://github.com/adammoses-github/mmm-dcmetrotraintimes
- Owner: AdamMoses-GitHub
- License: mit
- Created: 2017-02-03T01:51:57.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2018-04-18T18:29:16.000Z (over 6 years ago)
- Last Synced: 2024-08-04T10:03:14.471Z (5 months ago)
- Topics: dc, dmv, magicmirror, md, metro, schedule, transit, va, wmata
- Language: JavaScript
- Homepage:
- Size: 64.5 KB
- Stars: 16
- Watchers: 4
- Forks: 11
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Module: DC Metro Train Times
The `MMM-DCMetroTrainTimes` module is a module designed to display the train arrival times as stations along the Washington Metropolitan Area Transit Authority metro system, aka the Washington DC metro system. It is configurable based on the stations to get arrival times for, destinations to exclude, coloring line codes visually, and other options.
It also will show any incidents reported by WMATA on the rail lines by listing which color lines are currently affected, i.e. Orange, Blue, Silver, etc.
Example:
 
## Dependencies / Requirements
This module requires access to a WMATA Developers API key. For more information on acquiring thisplease visit .
You will also need to configure the metro stations of interest to you by using the station code which are listed in the seperate [./stationcodes/stationcodes.md](./stationcodes/stationcodes.md).
NOTE: The [./stationcodes/stationcodes.json](./stationcodes/stationcodes.json) file is actually used by the module so calls are not made to get it each time the module runs since the station codes and other information are rarely changed. If a problem occurs involving the codes you can run the [./stationcodes/getStationCodes.js](./stationcodes/getStationCodes.js) to update them.
## Using the module
To use this module, add it to the modules array in the `config/config.js` file:
````javascript
modules: [
{
module: 'MMM-DCMetroTrainTimes',
position: 'bottom_right',
config: {
// visit the url below for the wmata api key
// https://developer.wmata.com/
wmata_api_key: 'FILL IN',
// use the station codes file ./stationcodes/stationcodes.md for
// more on these values
stationsToShowList: [ 'C04', 'A04', 'D03' ],
}
}
]
````
## Configuration options
The following properties can be configured:
Option
Description
wmata_api_key
Used by the module to make calls to the WMATA JSON REST API. For more visit https://developer.wmata.com/.
This value is REQUIRED
stationsToShowList
Contains a JSON array of strings indicating WMATA Metro Station Code values. These are the stations you want to see train arrival times for. A table of these values can be found at ./stationcodes/stationcodes.md.
Example: [ 'C04', 'A04', 'D03' ]
This value is OPTIONAL, BUT EFFECTIVELY REQUIRED
Default value: [ 'A01', 'C01' ]
showIncidents
Toggle to turn on or off the incidents listing which will be shown before the train arrival times. Default is on.
Example: false
Default value: true
This value is OPTIONAL
showStationTrainTimes
Toggle to turn on or off the station train arrival times listing which is shown after the incidents listing. Default is on.
Example: false
Default value: true
This value is OPTIONAL
destinationsToExcludeList
Contains a JSON array of strings indicating WMATA Metro Station Code values. The station codes listed here will be hidden from any list of train arrivals for any of the stationsToShowList. This is useful if you live near the end of a line and aren't interested in taking trains towards your end. If left empty no destination stations will be excluded.
Example: [ 'N06', 'D13' ]
Default value: [ ]
This value is OPTIONAL
showDestinationFullName
Toggle to turn on or off full destination station names. Otherwise it will be an abbreviated destination station name. Default is on (full station name).
Example: false
Default value: true
This value is OPTIONAL
refreshRateIncidents
Specified in MILLISECONDS, sets the rate at which updates will be made to the metro incidents list. This value defaults to every two minutes. Note setting this value to low, i.e. fast, can use up a lot of alloted daily API calls so don't abuse this value. Also, incidents aren't updated nearly as often as train arrival times.
Example: 6 * 60 * 1000
Default value: 2 * 60 * 1000
This value is OPTIONAL
refreshRateStationTrainTimes
Specified in MILLISECONDS, sets the rate at which updates will be made to the station train arrival times list. This value defaults to every thirty seconds. Note setting this value to low, i.e. fast, can use up a lot of alloted daily API calls so don't abuse this value.
Example: 1 * 60 * 1000
Default value: 30 * 1000
This value is OPTIONAL
maxTrainTimesPerStation
The maximum number of train times to show per station, i.e. if you set this to 2 you would only ever get the 2 next train times for a given station. This defaults to zero which means show all the train times.
Example: 3
Default value: 0
This value is OPTIONAL
showHeader
Toggles the header title on or off.
Example: false
Default value: true
This value is OPTIONAL
headerText
The text to display in the header title.
Example: "WMATA Train Arrival Times"
Default value: "DC Metro Train Times"
This value is OPTIONAL
limitWidth
The width of cell containing the incident list, usually the widest cell. It effectively limits the total width of this module. Usually specified in pixels but can specified in any HTML width style. Specified as a string.
Example: "350px"
Default value: "200px"
This value is OPTIONAL
colorizeLines
Toggle this to enable colorzing any train line code or name by it's color, i.e. the Orange Line 'OR' will be colored orange, the Blue Line 'BL' will be colored blue, etc. Defaults to off to fit with the usual Magic Mirror look.
Example: true
Default value: false
This value is OPTIONAL
incidentCodesOnly
Toggle to change from the full text of the lines with incidents to just showing line codes, i.e. "Incident Reported On The Orange Line" as opposed to just showing "OR". Turned off by default to do a full-text listing of lines with incidents on them.
Example: true
Default value: false
This value is OPTIONAL
hideTrainTimesLessThan
Will exclude listing trains that are arriving in time less the specified amount in MINUTES. This is useful if for instance it took your four minutes to walk to your station so showing trains arriving less than four minutes would be useful. Note that is processed before maxTrainTimesPerStation. This defaults to zero which disables it.
Example: 4
Default value: 0
This value is OPTIONAL