{"id":13830490,"url":"https://github.com/CFenner/MMM-LocalTransport","last_synced_at":"2025-07-09T11:33:11.921Z","repository":{"id":45077402,"uuid":"53724377","full_name":"CFenner/MMM-LocalTransport","owner":"CFenner","description":"A module for the MagicMirror to display informations about local tranportation.","archived":false,"fork":false,"pushed_at":"2024-02-26T08:19:19.000Z","size":171,"stargazers_count":43,"open_issues_count":20,"forks_count":15,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-08-04T10:03:12.720Z","etag":null,"topics":["magicmirror","traffic"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CFenner.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"cfenner","ko_fi":"hafenstrand"}},"created_at":"2016-03-12T09:48:32.000Z","updated_at":"2024-08-04T10:03:17.524Z","dependencies_parsed_at":"2024-08-04T10:13:19.589Z","dependency_job_id":null,"html_url":"https://github.com/CFenner/MMM-LocalTransport","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CFenner%2FMMM-LocalTransport","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CFenner%2FMMM-LocalTransport/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CFenner%2FMMM-LocalTransport/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CFenner%2FMMM-LocalTransport/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CFenner","download_url":"https://codeload.github.com/CFenner/MMM-LocalTransport/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225539413,"owners_count":17485322,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["magicmirror","traffic"],"created_at":"2024-08-04T10:01:00.977Z","updated_at":"2024-11-20T11:30:50.636Z","avatar_url":"https://github.com/CFenner.png","language":"JavaScript","funding_links":["https://github.com/sponsors/cfenner","https://ko-fi.com/hafenstrand"],"categories":["Travel"],"sub_categories":[],"readme":"[![code climate](https://codeclimate.com/github/CFenner/MMM-LocalTransport/badges/gpa.svg)](https://codeclimate.com/github/CFenner/MMM-LocalTransport)\n[![License](https://img.shields.io/github/license/mashape/apistatus.svg)](https://choosealicense.com/licenses/mit/)\n\n# MMM-LocalTransport\n\nThis is a module for MagicMirror² to display the next local transport connection between an origin and destination.\n\n![preview](.github/preview-Berlin.png)\n\n## Usage\n\nYou need to install the module for your MagicMirror.\n\n### Installation\n\nNavigate into your MagicMirror's modules folder:\n\n```shell\ncd ~/MagicMirror/modules\n```\n\nClone this repository:\n\n```shell\ngit clone https://github.com/CFenner/MMM-LocalTransport\n```\n\nChange to the module's directory:\n\n```shell\ncd MMM-LocalTransport\n```\n\nInstall dependecies:\n\n```shell\nnpm install\n```\n\nConfigure the module in your config.js file.\n\n### Configuration\n\nAdd module configuration to config.js.\n\n```js\n{\n  module: 'MMM-LocalTransport',\n  position: 'ANY_POSITION',\n  config: {\n    api_key: 'YOUR_API KEY',\n    origin: 'YOUR_ORIGIN',\n    destination: 'YOUR_DESTINATION'\n  }\n},\n```\n\n|Option|Description|\n|---|---|\n|`apiKey`|The API key, which can be obtained [here](https://developers.google.com/maps/documentation/directions/).\u003cbr\u003e\u003cbr\u003eThis value is **REQUIRED**|\n|`origin`|The start location.\u003cbr\u003e\u003cbr\u003e**Example:** `Mannheim HBF`\u003cbr\u003eThis value is **REQUIRED**|\n|`destination`|The target location.\u003cbr\u003e\u003cbr\u003e**Example:** `Frankfurt HBF`\u003cbr\u003eThis value is **REQUIRED**|\n|`maximumEntries`|Maximum number of routes to display. Less routes will be shown if less are returned by Google. Routes will be sorted by arrival time. This option should take an integer value between `1` and `5`.\u003cbr\u003e\u003cbr\u003e**Default value:** `3`|\n|`updateInterval`|How often does the content need to be fetched? (Minutes) Note that the module refreshes every 15 seconds to always display an accurate estimate when you need to leave.\u003cbr\u003e\u003cbr\u003e**Default value:** `5`|\n|`animationSpeed`|Speed of the update animation. (Seconds)\u003cbr\u003e\u003cbr\u003e**Default value:** `1`|\n|`displayStationLength`|Number of characters of the departure station for each transport mode to display. \u003cbr\u003e`0` means display all, \u003cbr\u003e`-1` means don't show the departure station\u003cbr\u003e\u003cbr\u003e**Default value:** `0`|\n|`displayArrival`|Boolean if the arrival time should be shown in the header for each option.\u003cbr\u003e\u003cbr\u003e**Default value:** `true`|\n|`displayWalkType`|String how detailed the walking segments should be shown. \u003cbr\u003e `'none'` means to not display anything,\u003cbr\u003e `'short'` means to display the symbol, the time and the short version of the unit or \u003cbr\u003e `'long'` means that a symbol, the time and the long string for the unit is displayed. This options is default if an invalid string is supplied.\u003cbr\u003e\u003cbr\u003e**Default value:** `'short'`|\n|`maxWalkTime`|Maximum time you are willing to walk between stations in minutes\u003cbr\u003e\u003cbr\u003e**Default value:** `10`|\n|`maxModuleWidth`|Maximum width of the module in pixel. Unlimited when set to `0`. This option can be used to make the module shorter in case of very long lines for directions. \u003cbr\u003e\u003cbr\u003e**Default value:** `0`|\n|`fade`|Boolean if a fade should be applied - same as for calendar module\u003cbr\u003e\u003cbr\u003e**Default value:** `true`|\n|`fadePoint`|Percentage, where the fade should start. This should be a value between 0 and 1 - same as for calendar module\u003cbr\u003e\u003cbr\u003e**Default value:** `0.1`|\n|`showColor`|Boolean if transport symbols should be displayed in color (Note: symbols for default transport modes are always in grey)\u003cbr\u003e\u003cbr\u003e**Default value:** `true`|\n|`language`|Language to display information in - german `de` or english `en`\u003cbr\u003e\u003cbr\u003e**Default value** `is same as defined in the main config file`|\n|`units`|Units to use - `metric` or `imperial`\u003cbr\u003e\u003cbr\u003e**Default value** `is same as defined in the main config file`|\n|`timeFormat`|`24` or `12` hour clock for displaying the arrival time\u003cbr\u003e\u003cbr\u003e**Default value** `is same as defined in the main config file`|\n\n## Preview of various settings\n\n```js\n{\n  module: 'MMM-LocalTransport',\n  header: 'to Victoriy Coach Station',\n  position: 'top_left',\n  config: {\n    api_key: 'MYG00GLEAP1KEY',\n    origin: 'Waterloo Station, London, United Kingdom',\n    destination: 'Victoria Coach Station, London, United Kingdom',\n    maximumEntries: 4,\n    maxWalkTime: 15,\n    displayWalkType: 'full',\n    maxModuleWidth: 400\n  }\n},\n```\n\n![London - left long block](.github/preview-London.png)\n\n```js\n{\n  module: 'MMM-LocalTransport',\n  header: 'nach Berlin',\n  position: 'top_right',\n  config: {\n    api_key: 'MYG00GLEAP1KEY',\n    origin: 'Bahnhof Hamburg Altona, Hamburg, Germany',\n    destination: 'Berlin Hauptbahnhof, Berlin, Germany',\n    maximumEntries: 6,\n    maxWalkTime: 15,\n    displayStationLength: -1,\n    displayWalkType: 'none',\n    displayArrival: false,\n    language: 'de'\n  }\n},\n```\n\n![Berlin - right short](.github/preview-Berlin.png)\n\n```js\n{\n  module: 'MMM-LocalTransport',\n  header: 'to Museum of Art',\n  position: 'top_left',\n  config: {\n    api_key: 'MYG00GLEAP1KEY',\n    origin: 'MetLife Stadium, 1 MetLife Stadium Drive, East Rutherford, NJ 07073, US',\n    destination: '1000 5th Ave, New York, NY 10028, US',\n    maximumEntries: 3,\n    maxWalkTime: 30,\n    displayStationLength: 10\n  }\n},\n```\n\n![New York - left](.github/preview-NewYork.png)\n\n## Special Thanks\n\nThanks to [SamLewis0602](https://github.com/SamLewis0602) for his module [MMM-Traffic by SamLewis0602](https://github.com/SamLewis0602/MMM-Traffic) on which this one is based on.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCFenner%2FMMM-LocalTransport","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCFenner%2FMMM-LocalTransport","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCFenner%2FMMM-LocalTransport/lists"}