{"id":13723141,"url":"https://github.com/maxalmonte14/nfl-scores","last_synced_at":"2026-01-11T15:59:37.187Z","repository":{"id":62525553,"uuid":"148950854","full_name":"maxalmonte14/nfl-scores","owner":"maxalmonte14","description":"A CLI for getting NFL games real-time data.","archived":false,"fork":false,"pushed_at":"2018-11-02T14:04:30.000Z","size":7019,"stargazers_count":15,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-11-14T12:50:58.485Z","etag":null,"topics":["cli","console","football","nfl","php","php7","sports","terminal","tool"],"latest_commit_sha":null,"homepage":"","language":"PHP","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/maxalmonte14.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-09-16T00:36:08.000Z","updated_at":"2023-09-24T04:51:00.000Z","dependencies_parsed_at":"2022-11-02T10:45:28.604Z","dependency_job_id":null,"html_url":"https://github.com/maxalmonte14/nfl-scores","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/maxalmonte14%2Fnfl-scores","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxalmonte14%2Fnfl-scores/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxalmonte14%2Fnfl-scores/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxalmonte14%2Fnfl-scores/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maxalmonte14","download_url":"https://codeload.github.com/maxalmonte14/nfl-scores/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252915433,"owners_count":21824559,"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","console","football","nfl","php","php7","sports","terminal","tool"],"created_at":"2024-08-03T01:01:36.583Z","updated_at":"2026-01-11T15:59:37.182Z","avatar_url":"https://github.com/maxalmonte14.png","language":"PHP","funding_links":[],"categories":["Projects using Laravel Zero"],"sub_categories":[],"readme":"About NFL-Scores\n====================\n\n[![Build Status](https://travis-ci.org/maxalmonte14/nfl-scores.svg?branch=master)](https://travis-ci.org/maxalmonte14/nfl-scores)\n[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/maxalmonte14/nfl-scores/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/maxalmonte14/nfl-scores/?branch=master)\n[![Code Coverage](https://scrutinizer-ci.com/g/maxalmonte14/nfl-scores/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/maxalmonte14/nfl-scores/?branch=master)\n[![Build Status](https://scrutinizer-ci.com/g/maxalmonte14/nfl-scores/badges/build.png?b=master)](https://scrutinizer-ci.com/g/maxalmonte14/nfl-scores/build-status/master)\n[![StyleCI](https://github.styleci.io/repos/148950854/shield?branch=master)](https://github.styleci.io/repos/148950854)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\nNFL-Scores is a CLI program that allows you to see the scores of live NFL games, as well as the list of games of the day and the current weekly schedule.\n\n## Requirements\n\n```\nPHP \u003e= 7.1.3\n```\n\n## Installation\n\n```\ncomposer require \"maxalmonte14/nfl-scores\"\n```\n\n## How to use\n\n### Getting all live games\n\n```\nphp nfl-scores live\n```\n\nThat will show you something like this.\n\n```\nBAL VS BUF @ M\u0026T Bank Stadium\n3rd Quarter | 13:48 | BAL 1st \u0026 10\n+-----+----+----+---+---+----+----+\n|     | 1  | 2  | 3 | 4 | OT | T  |\n+-----+----+----+---+---+----+----+\n| BAL | 14 | 12 | 0 | 0 | 0  | 26 |\n| BUF | 0  | 0  | 0 | 0 | 0  | 0  |\n+-----+----+----+---+---+----+----+\n\n\nCLE VS PIT @ FirstEnergy Stadium\n3rd Quarter | 08:24 | PIT 1st \u0026 10\n+-----+---+---+---+---+----+----+\n|     | 1 | 2 | 3 | 4 | OT | T  |\n+-----+---+---+---+---+----+----+\n| CLE | 0 | 0 | 7 | 0 | 0  | 7  |\n| PIT | 0 | 7 | 7 | 0 | 0  | 14 |\n+-----+---+---+---+---+----+----+\n```\n\nYou can see the teams that are playing, at which stadium, the current quarter, the clock, the possession team, the current down, and the yards to go. Pretty good, ah?\n\n### Getting your favorite team live game\n\nYou can get one specific live game just passing a parameter with your team abbreviation to the `live` command.\n\n```\nphp nfl-scores live CLE\n```\n\nAnd now you have the Cleveland Browns game live on your terminal!\n\n```\nCLE VS PIT @ FirstEnergy Stadium\n3rd Quarter | 08:24 | PIT 1st \u0026 10\n+-----+---+---+---+---+----+----+\n|     | 1 | 2 | 3 | 4 | OT | T  |\n+-----+---+---+---+---+----+----+\n| CLE | 0 | 0 | 7 | 0 | 0  | 7  |\n| PIT | 0 | 7 | 7 | 0 | 0  | 14 |\n+-----+---+---+---+---+----+----+\n```\n\n### Getting a list of today's games\n\nIf you want to see what teams are going to play today you can use the `today` command.\n\n```\nphp nfl-scores today\n```\n\nThat will show an output as the following.\n\n```\n+------+---------+-------------------------------+------------+-------------+\n| Home | Visitor | Stadium                       | Date       | Hour        |\n+------+---------+-------------------------------+------------+-------------+\n| ATL  | NO      | Mercedes-Benz Stadium         | 09/23/2018 | 13:00:00 ET |\n| LA   | LAC     | Los Angeles Memorial Coliseum | 09/23/2018 | 16:05:00 ET |\n| ARI  | CHI     | State Farm Stadium            | 09/23/2018 | 16:25:00 ET |\n| SEA  | DAL     | CenturyLink Field             | 09/23/2018 | 16:25:00 ET |\n| DET  | NE      | Ford Field                    | 09/23/2018 | 20:20:00 ET |\n| BAL  | DEN     | M\u0026T Bank Stadium              | 09/23/2018 | 13:00:00 ET |\n| CAR  | CIN     | Bank of America Stadium       | 09/23/2018 | 13:00:00 ET |\n| HOU  | NYG     | NRG Stadium                   | 09/23/2018 | 13:00:00 ET |\n| JAX  | TEN     | TIAA Bank Field               | 09/23/2018 | 13:00:00 ET |\n| KC   | SF      | Arrowhead Stadium             | 09/23/2018 | 13:00:00 ET |\n| MIA  | OAK     | Hard Rock Stadium             | 09/23/2018 | 13:00:00 ET |\n| MIN  | BUF     | U.S. Bank Stadium             | 09/23/2018 | 13:00:00 ET |\n| PHI  | IND     | Lincoln Financial Field       | 09/23/2018 | 13:00:00 ET |\n| WAS  | GB      | FedExField                    | 09/23/2018 | 13:00:00 ET |\n+------+---------+-------------------------------+------------+-------------+\n\n```\n\n### Getting today's finished games\n\nThe `live` command won't show you the finished games, so, if want to know the final results of a game you should use the `finished` command.\n\n```\nphp nfl-scores finished\n```\n\nThe output will be like the following:\n\n```\nPHI VS ATL @ Lincoln Financial Field\n+-----+---+---+---+---+----+----+\n|     | 1 | 2 | 3 | 4 | OT | T  |\n+-----+---+---+---+---+----+----+\n| PHI | 0 | 3 | 7 | 8 | 0  | 18 |\n| ATL | 3 | 3 | 0 | 6 | 0  | 12 |\n+-----+---+---+---+---+----+----+\n\nBAL VS BUF @ M\u0026T Bank Stadium\n+-----+----+----+----+---+----+----+\n|     | 1  | 2  | 3  | 4 | OT | T  |\n+-----+----+----+----+---+----+----+\n| BAL | 14 | 12 | 14 | 8 | 0  | 47 |\n| BUF | 0  | 0  | 3  | 0 | 0  | 3  |\n+-----+----+----+----+---+----+----+\n```\n\nYou can also get one specific game passing a parameter to the `finished` command.\n\n```\nphp nfl-scores finished PHI\n```\n\nThe output will be like the following:\n\n```\nPHI VS ATL @ Lincoln Financial Field\n+-----+---+---+---+---+----+----+\n|     | 1 | 2 | 3 | 4 | OT | T  |\n+-----+---+---+---+---+----+----+\n| PHI | 0 | 3 | 7 | 8 | 0  | 18 |\n| ATL | 3 | 3 | 0 | 6 | 0  | 12 |\n+-----+---+---+---+---+----+----+\n```\n\n### Getting the games for this week\n\nThe `week` command will show the games for the current week.\n\n```\nphp nfl-scores week\n```\n\n\u003e **Note**: Remember, a week in the NFL is composed by a Thursday, a Sunday and the Monday of next week.\n\nThe output will be similar to the following.\n\n```\n+------+---------+-------------------------------+------------+-------------+\n| Home | Visitor | Stadium                       | Date       | Hour        |\n+------+---------+-------------------------------+------------+-------------+\n| ATL  | NO      | Mercedes-Benz Stadium         | 09/23/2018 | 13:00:00 ET |\n| LA   | LAC     | Los Angeles Memorial Coliseum | 09/23/2018 | 16:05:00 ET |\n| ARI  | CHI     | State Farm Stadium            | 09/23/2018 | 16:25:00 ET |\n| SEA  | DAL     | CenturyLink Field             | 09/23/2018 | 16:25:00 ET |\n| DET  | NE      | Ford Field                    | 09/23/2018 | 20:20:00 ET |\n| BAL  | DEN     | M\u0026T Bank Stadium              | 09/23/2018 | 13:00:00 ET |\n| CAR  | CIN     | Bank of America Stadium       | 09/23/2018 | 13:00:00 ET |\n| HOU  | NYG     | NRG Stadium                   | 09/23/2018 | 13:00:00 ET |\n| JAX  | TEN     | TIAA Bank Field               | 09/23/2018 | 13:00:00 ET |\n| KC   | SF      | Arrowhead Stadium             | 09/23/2018 | 13:00:00 ET |\n| MIA  | OAK     | Hard Rock Stadium             | 09/23/2018 | 13:00:00 ET |\n| MIN  | BUF     | U.S. Bank Stadium             | 09/23/2018 | 13:00:00 ET |\n| PHI  | IND     | Lincoln Financial Field       | 09/23/2018 | 13:00:00 ET |\n| WAS  | GB      | FedExField                    | 09/23/2018 | 13:00:00 ET |\n| TB   | PIT     | Raymond James Stadium         | 09/24/2018 | 20:15:00 ET |\n| CLE  | NYJ     | FirstEnergy Stadium           | 09/20/2018 | 20:20:00 ET |\n+------+---------+-------------------------------+------------+-------------+\n\n```\n\n## What this program cannot do\n\nThis program has its limitations, the NFL hasn't an open API to get precise data at any time you want, so I'm using an NFL Game Center JSON file which is updated every certain time to get the data that the CLI show.\n\nFor that reason this program cannot do the following things:\n\n- Show information about games played before the current NFL week.\n- Show player stats, because they're not contained in the JSON file.\n\n## What this program doesn't do but could do!\n\nThere is a lot of things that I would love to add in future versions of this program, these are some of them:\n\n- Show the output in a prettier way. Everybody loves nice things!\n- Update the data in real time. For the moment anytime you run the live command the program will show you the score at that time, you need to run the command over and over again every time you want to see the updated data.\n- Show notifications every time a team scores or the game is finished.\n- Store passed games in a database.\n\n## What this program can improve\n\nThere is a lot of things that can be done to improve this program, there are a few of them:\n\n- Refactor! Everything turns better when you refactor it.\n- Add some Feature tests. Of course this program has a test suite, but I focused on the Unit tests, so adding some features test is a must-do task.\n- Speed up. Everybody loves fast things.\n\n## Contributing\n\nDo you like this little app? Do you follow the PSR standards? It sounds good to me! Send me a PR, and don't forget to add some tests.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxalmonte14%2Fnfl-scores","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaxalmonte14%2Fnfl-scores","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxalmonte14%2Fnfl-scores/lists"}