{"id":13830461,"url":"https://github.com/fewieden/MMM-soccer","last_synced_at":"2025-07-09T11:33:07.717Z","repository":{"id":10169820,"uuid":"64405523","full_name":"fewieden/MMM-soccer","owner":"fewieden","description":"European Soccer Standings Module for MagicMirror²","archived":false,"fork":false,"pushed_at":"2024-03-03T13:03:06.000Z","size":1055,"stargazers_count":32,"open_issues_count":16,"forks_count":24,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-08-04T10:03:08.984Z","etag":null,"topics":["bundesliga","eredivisie","football","football-data","league-table","ligue1","magicmirror","premier-league","primera-division","serie-a","soccer","standings","voice-control"],"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/fewieden.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","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},"funding":{"github":"fewieden","custom":["https://paypal.me/fewieden"]}},"created_at":"2016-07-28T15:10:52.000Z","updated_at":"2024-08-04T10:03:15.512Z","dependencies_parsed_at":"2024-01-15T17:39:12.496Z","dependency_job_id":"15b0065d-1d2f-412f-9db0-dfeabf58f370","html_url":"https://github.com/fewieden/MMM-soccer","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fewieden%2FMMM-soccer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fewieden%2FMMM-soccer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fewieden%2FMMM-soccer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fewieden%2FMMM-soccer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fewieden","download_url":"https://codeload.github.com/fewieden/MMM-soccer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225539399,"owners_count":17485319,"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":["bundesliga","eredivisie","football","football-data","league-table","ligue1","magicmirror","premier-league","primera-division","serie-a","soccer","standings","voice-control"],"created_at":"2024-08-04T10:01:00.393Z","updated_at":"2024-11-20T11:30:46.898Z","avatar_url":"https://github.com/fewieden.png","language":"JavaScript","funding_links":["https://github.com/sponsors/fewieden","https://paypal.me/fewieden"],"categories":["Sports"],"sub_categories":[],"readme":"# MMM-soccer [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)](https://raw.githubusercontent.com/fewieden/MMM-soccer/master/LICENSE) ![Build status](https://github.com/fewieden/MMM-soccer/workflows/build/badge.svg) [![Code Climate](https://codeclimate.com/github/fewieden/MMM-soccer/badges/gpa.svg?style=flat)](https://codeclimate.com/github/fewieden/MMM-soccer) [![Known Vulnerabilities](https://snyk.io/test/github/fewieden/mmm-soccer/badge.svg)](https://snyk.io/test/github/fewieden/mmm-soccer) [![codecov](https://codecov.io/gh/fewieden/MMM-soccer/branch/master/graph/badge.svg?token=vB22qyfCXz)](https://codecov.io/gh/fewieden/MMM-soccer)\n\nEuropean Soccer Standings Module for MagicMirror²\n\n## Example\n\n![](.github/regular.png) ![](.github/modal.png)\n\n## Dependencies\n\n* An installation of [MagicMirror²](https://github.com/MichMich/MagicMirror)\n* OPTIONAL: [Voice Control](https://github.com/fewieden/MMM-voice) and [MMM-Modal](https://github.com/fewieden/MMM-Modal)\n* npm\n* [node-fetch](https://www.npmjs.com/package/node-fetch)\n\n## Installation\n\n* Clone this repo into `~/MagicMirror/modules` directory.\n* Configure your `~/MagicMirror/config/config.js`:\n\n```js\n{\n    module: 'MMM-soccer',\n    position: 'bottom_right',\n    config: {\n        // add your config options here\n    }\n}\n```\n\n* Run command `npm i --production` in `~/MagicMirror/modules/MMM-soccer` directory.\n* Optional: Get a free api key [here](http://api.football-data.org/register)\n\n## Config Options\n\n| **Option** | **Default** | **Description** |\n| --- | --- | --- |\n| `api_key` | false | Either false (limited to 50 requests a day) or an API Key obtained from \u003chttp://api.football-data.org/register\u003e (limited to 50 requests a minute) . |\n| `colored` | false | Boolean to show club logos in color or not. |\n| `show` | 'GERMANY' | Which league should be displayed  'GERMANY', 'FRANCE', 'ENGLAND', 'SPAIN' or 'ITALY' |\n| `focus_on` | false | Which team should the standings focus on per league e.g. {\"GERMANY\": \"FC Bayern München\", \"FRANCE\": \"Olympique Lyonnais\"}. Omit this option or set to false to show the full league table. |\n| `max_teams` | false | How many teams should be displayed. Omit this option or set to false to show the full league table. |\n| `leagues` | `{\"GERMANY\": \"BL1\", \"FRANCE\": \"FL1\", \"ENGLAND\": \"PL\", \"SPAIN\": \"PD\", \"ITALY\": \"SA\"}` | A collection of leagues obtained from \u003chttp://api.football-data.org/v2/competitions\u003e |\n| `logos` | `false` | Boolean to show club logos or not. |\n\n## OPTIONAL: Voice Control and Modal\n\nThis module supports voice control by [MMM-voice](https://github.com/fewieden/MMM-voice) and [MMM-Modal](https://github.com/fewieden/MMM-Modal).\nIn order to use this feature, it's required to install the voice and modal modules. There are no extra config options for voice control and modals needed.\n\n### Mode\n\nThe voice control mode for this module is `SOCCER`\n\n### List of all Voice Commands\n\n* OPEN HELP -\u003e Shows the information from the readme here with mode and all commands.\n* CLOSE HELP -\u003e Hides the help information.\n* SHOW STANDINGS OF COUNTRY NAME -\u003e Switch standings to specific league.\n  Valid country names are (Default: GERMANY, FRANCE, ENGLAND, SPAIN or ITALY)\n  set in config. (Effect stays until your mirror restarts, for permanent change\n  you have to edit the config)\n* EXPAND VIEW -\u003e Expands the standings table and shows all teams.\n* COLLAPSE VIEW -\u003e Collapse the expanded view.\n\n## Developer\n\n* `npm run lint` - Lints JS and CSS files.\n* `npm run docs` - Generates documentation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffewieden%2FMMM-soccer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffewieden%2FMMM-soccer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffewieden%2FMMM-soccer/lists"}