{"id":13357640,"url":"https://github.com/manrajgrover/football-cli","last_synced_at":"2025-05-15T23:05:09.079Z","repository":{"id":10711487,"uuid":"66293963","full_name":"manrajgrover/football-cli","owner":"manrajgrover","description":"⚽ Command line interface for Hackers who love football","archived":false,"fork":false,"pushed_at":"2022-12-08T18:48:21.000Z","size":2767,"stargazers_count":1075,"open_issues_count":26,"forks_count":79,"subscribers_count":27,"default_branch":"master","last_synced_at":"2025-05-15T23:05:04.426Z","etag":null,"topics":["cli","command-line-tool","cup","fifa","football","javascript","nodejs","soccer","world"],"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/manrajgrover.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-08-22T17:33:22.000Z","updated_at":"2025-05-03T02:10:43.000Z","dependencies_parsed_at":"2023-01-13T16:06:27.895Z","dependency_job_id":null,"html_url":"https://github.com/manrajgrover/football-cli","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/manrajgrover%2Ffootball-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manrajgrover%2Ffootball-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manrajgrover%2Ffootball-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manrajgrover%2Ffootball-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/manrajgrover","download_url":"https://codeload.github.com/manrajgrover/football-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254436944,"owners_count":22070946,"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":["cli","command-line-tool","cup","fifa","football","javascript","nodejs","soccer","world"],"created_at":"2024-07-29T21:03:14.382Z","updated_at":"2025-05-15T23:05:08.959Z","avatar_url":"https://github.com/manrajgrover.png","language":"JavaScript","funding_links":[],"categories":["Tools","JavaScript"],"sub_categories":["Node"],"readme":"# football-cli\n[![Build Status](https://travis-ci.org/manrajgrover/football-cli.svg?branch=master)](https://travis-ci.org/manrajgrover/football-cli) [![npm version](https://badge.fury.io/js/footballcli.svg)](https://www.npmjs.com/package/footballcli) [![npm](https://img.shields.io/npm/dt/footballcli.svg?maxAge=2592000?style=flat-square)](https://www.npmjs.com/package/footballcli) ![awesome](https://img.shields.io/badge/awesome-yes-green.svg)\n\u003e Command line interface for Hackers who love football ⚽\n\n![Standings](https://raw.githubusercontent.com/manrajgrover/football-cli/master/assets/football-standings.gif)\n\n## Installation\n\n**Run**\n\n```shell\n$ npm install -g footballcli\n```\n\n## How to get API Key?\n\nPlease register on [football-data.org](http://api.football-data.org/register) to get your API Key. Then run `$ football config` to add your API Key (use `sudo` if required). Requests made using API key increases your rate limit from 50 requests per day to 50 requests per minute.\n\n## Usage\n\n### Commands available\n\n```shell\nfootball \u003ccommand\u003e\n\nCommands:\n  scores     Get scores of past and live fixtures\n  fixtures   Get upcoming and past fixtures of a league and team\n  standings  Get standings of particular league\n  lists      List of codes of various competitions\n  config     Change configuration and defaults\n\nOptions:\n  -h, --help  Show help                                          [boolean]\n  \n```\n\n#### Command `scores`\nGet scores of past and live fixtures\n\n![Standings](https://raw.githubusercontent.com/manrajgrover/football-cli/master/assets/football-livescores.gif)\n\n```shell\nUsage: football scores [options]\n\nOptions:\n  -h, --help  Show help                                          [boolean]\n  -l, --live  Live scores                                        [boolean]\n  -t, --team  Select team                                        [string]\n\nExamples:\n  football scores -t \"Manchester United\" -l\n  \n```\n\n#### Command `fixtures`\nGet upcoming and past fixtures of a league and team\n\n```shell\nUsage: football fixtures [options]\n\nOptions:\n  -h, --help    Show help                                         [boolean]\n  -d, --days    Number of days from today                         [number]\n  -l, --league  League                                            [string]\n  -t, --team    Team name or substring of it                      [string]\n  -n, --next    Next or upcoming matches                          [boolean]\n\nExamples:\n  football fixtures -l PL -d 5 -t \"Manchester United\" -n\n\n```\n\n![Fixtures](https://raw.githubusercontent.com/manrajgrover/football-cli/master/assets/football-fixtures.gif)\n\n#### Command `standings`\nGet standings of particular league\n\n```shell\nUsage: football standings [options]\n\nOptions:\n  -h, --help    Show help                                         [boolean]\n  -l, --league  League to be searched                             [required]\n\nExamples:\n  football standings -l PL\n\n```\n\n#### Command `lists`\nList of codes of various competitions\n\n```shell\nUsage: football lists [options]\n\nOptions:\n  -h, --help     Show help                                        [boolean]\n  -r, --refresh  Refresh league ids                               [boolean]\n\nExamples:\n  football lists -r\n\n```\n\n#### Command `config`\nChange configuration and defaults\n\n```shell\nUsage: football config\n\nOptions:\n  -h, --help  Show help                                           [boolean]\n\nExamples:\n  football config\n  \n```\n\n## Note\n\nFor World Cup fixtures, you need to specify `league` flag with value as `WC`. API does not provide world cup information in consolidated response and is a known bug.\n\n## Development\n\nRun:\n\n```sh\n$ git clone https://github.com/manrajgrover/football-cli.git\n$ cd football-cli\n$ npm link\n```\n\nThis will setup a symbolic link to the CLI. Any changes in source files will now be reflected when running the `football` command.\n\nTo lint your code, run\n\n```sh\n$ npm run lint\n```\n\n## Get in touch\n\nSay hi on [twitter](https://twitter.com/manrajsgrover) and share this project by clicking [here](https://twitter.com/home?status=Checkout%20command%20line%20tool%20for%20checking%20live%20%23scores,%20%23fixtures%20and%20more%20on%20%23Github%20by%20%40manrajsgrover%20%23cli%20https%3A//github.com/manrajgrover/football-cli)\n\n## Related\nYou may find similar packages [here](http://api.football-data.org/libraries)\n\n## License\n\n[MIT](https://github.com/manrajgrover/football-cli/blob/master/LICENSE) © manrajgrover\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanrajgrover%2Ffootball-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanrajgrover%2Ffootball-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanrajgrover%2Ffootball-cli/lists"}