{"id":13830507,"url":"https://github.com/yo-less/MMM-KVV","last_synced_at":"2025-07-09T11:33:17.579Z","repository":{"id":217324841,"uuid":"66576936","full_name":"yo-less/MMM-KVV","owner":"yo-less","description":"MagicMirror² module - KVV (Karlsruhe public transport) station monitor","archived":false,"fork":false,"pushed_at":"2019-03-07T23:00:17.000Z","size":259,"stargazers_count":11,"open_issues_count":3,"forks_count":7,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-08-04T10:03:15.167Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/yo-less.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2016-08-25T16:58:18.000Z","updated_at":"2024-08-04T10:03:19.631Z","dependencies_parsed_at":null,"dependency_job_id":"2cbc9064-0842-4040-bcce-089202de2872","html_url":"https://github.com/yo-less/MMM-KVV","commit_stats":null,"previous_names":["yo-less/mmm-kvv"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yo-less%2FMMM-KVV","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yo-less%2FMMM-KVV/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yo-less%2FMMM-KVV/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yo-less%2FMMM-KVV/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yo-less","download_url":"https://codeload.github.com/yo-less/MMM-KVV/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225539423,"owners_count":17485326,"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":[],"created_at":"2024-08-04T10:01:01.258Z","updated_at":"2024-11-20T11:30:54.482Z","avatar_url":"https://github.com/yo-less.png","language":"JavaScript","funding_links":[],"categories":["Travel"],"sub_categories":[],"readme":"# MMM-KVV\n\u003cB\u003eStation monitor\u003c/B\u003e for the \u003cB\u003eKarlsruhe local transport (KVV)\u003c/B\u003e bus, tram and train system.\u003cP\u003e\n\nThis module is an extension of the amazing [MagicMirror\u003csup\u003e2\u003c/sup\u003e](https://github.com/MichMich/MagicMirror) project by [MichMich](https://github.com/MichMich/) which has inspired me to share my coding skills with others as well. Check it out, you know you want to :). \u003cP\u003e\n\nIt's always nice to see mirrors using my work, so feel free to send me some screenshots of your implementations.\u003cP\u003e\n\nLastly, why not join in on our discussions at the official [MagicMirror\u003csup\u003e2\u003c/sup\u003e Forum](http://forum.magicmirror.builders/)?\n\n## Screenshots\n\n![German version](screenshots/screenshot_de.png)\n![English version](screenshots/screenshot_en.png)\n\n## Current version\n\nv1.0.3\n\n## Languages\nAs of version 1.0.0, MMM-KVV features language support for `German (de)` and `English (en)` mirrors.\n\n## Prerequisite\nA working installation of [MagicMirror\u003csup\u003e2\u003c/sup\u003e](https://github.com/MichMich/MagicMirror)\n \n## Dependencies\n  * npm\n  * [request](https://www.npmjs.com/package/request)\n\n## Installation\n1. Navigate into your MagicMirror's `modules` folder.\n2. Execute `git clone https://github.com/yo-less/MMM-KVV.git`.\n3. Execute `cd MMM-KVV`.\n3. Execute `npm install`.\n\n## Module behavior\nPlease note that this module auto-creates a module header which displays the name of the chosen Karlsruhe local transport stop. It is therefore recommended not to add a 'header' entry to your config.js for this module.\u003cP\u003e\nThis module automatically disappears from your mirror as soon as a station has stopped offering connections at night. It reappears as soon as your chosen station is scheduled to be served again.\u003cP\u003e\nThis module has been programmed to allow for multiple instances. Simply add more MMM-KVV config entries to your config.js file to display multiple stations and configure them according to your needs.\n\n## Configuration\nSample minimum configuration entry for your `~/MagicMirror/config/config.js`:\n\n    ...\n    \n    {\n        module: 'MMM-KVV',\n        position: 'top_left',\n        config: {\n\t\t\tstopID: '',\t\t// Which stop would you like to have displayed?\t\t\t\n        }\n    } \t\t\t\t\t\t// If this isn't your last module, add a comma after the bracket\n    \n    ...\n\nSample configuration entry for your `~/MagicMirror/config/config.js` with optional parameters:\n\n    ...\n    \n    {\n        module: 'MMM-KVV',\n        position: 'top_left',\n        config: {\n\t\t\tstopID: '',\t\t// Which stop would you like to have displayed?\n\t\t\tmaxConn: 6,\t\t// How many connections would you like to see? (Maximum: 10)\n\t\t\tlines: '',\t\t// What lines are you interested in?\n\t\t\tdirection: '',\t// If you want to, you can limit the information to one of two directions\n\t\t\tlabelRow: true, // Show or hide column headers\n\t\t    reload: 60000 \t// How often should the information be updated? (In milliseconds)\n        }\n    } \t\t\t\t\t\t// If this isn't your last module, add a comma after the bracket\n    \n    ...\n\n## Figuring out the correct stopID\n1. Open your web browser and navigate to the [KVV Live Web Page](http://live.kvv.de).\n2. Use the search field to find the stop you are interested in.\n3. Once you can see the list of connections for your stop in your browser, note the information after \"stopId=\",\u003cBR\u003e this is the `StopID` you are looking for.\n\n## Config Options\n| **Option** | **Default** | **Description** |\n| :---: | :---: | --- |\n| stopID | de:8212:89 | \u003cBR\u003eWhich stop would you like to have displayed? \u003cBR\u003e\u003cEM\u003e Default: Karlsruhe central station (tram stop)\u003c/EM\u003e\u003cP\u003e |\n| maxConn\u003cBR\u003e`optional` | 8 | \u003cBR\u003e How many connections would you like to see? \u003cBR\u003e\u003cEM\u003e\u003cB\u003eNote\u003c/B\u003e: The KVV API limits the maximum number of connections to 10.\u003c/EM\u003e\u003cP\u003e |\n| lines\u003cBR\u003e`optional` |  | \u003cBR\u003e Only show connections for specific lines - use commas to choose multiple lines.\u003cBR\u003e\u003cEM\u003e Example values: '3, S1'\u003cBR\u003e\u003cB\u003eNote\u003c/B\u003e: You \u003cB\u003ecan\u003c/B\u003e use spaces when setting this parameter in order to enhance legibility.\u003c/EM\u003e\u003cP\u003e |\n| direction\u003cBR\u003e`optional` |  | \u003cBR\u003e There are really \"two\" stops to every stop, depending on what side of the street you're standing on. You can limit the presented information to one of those \"two\" stops.\u003cBR\u003e \u003cEM\u003ePossible values: 1, 2\u003c/EM\u003e\u003cP\u003e |\n| labelRow\u003cBR\u003e`optional` | true | \u003cBR\u003e Show or hide column headers\u003cBR\u003e \u003cEM\u003ePossible values: true, false\u003c/EM\u003e\u003cP\u003e |\n| reload\u003cBR\u003e`optional`  | 60000 | \u003cBR\u003e How often should the information be updated? (In milliseconds) \u003cBR\u003e\u003cEM\u003e Default: Every minute \u003c/EM\u003e\u003cP\u003e |\n\n## Licence\nMIT License\n\nCopyright (c) 2016 yo-less (https://github.com/yo-less/)\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyo-less%2FMMM-KVV","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyo-less%2FMMM-KVV","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyo-less%2FMMM-KVV/lists"}