PHPackages maxalmonte14/nfl-scores - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [CLI & Console](/categories/cli) 4. / 5. maxalmonte14/nfl-scores ActiveProject[CLI & Console](/categories/cli) maxalmonte14/nfl-scores ======================= A CLI for getting NFL games real-time data. v1.3.1(7y ago)1619MITPHPPHP ^7.1.3 Since Sep 16Pushed 7y ago3 watchersCompare [ Source](https://github.com/maxalmonte14/nfl-scores)[ Packagist](https://packagist.org/packages/maxalmonte14/nfl-scores)[ RSS](/packages/maxalmonte14-nfl-scores/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (7)Dependencies (5)Versions (9)Used By (0) About NFL-Scores ================ [](#about-nfl-scores) [![Build Status](https://camo.githubusercontent.com/fe612f0159aa65dbb604f364d81ede430da343c3e42a992fa4f73694cf56c5e9/68747470733a2f2f7472617669732d63692e6f72672f6d6178616c6d6f6e746531342f6e666c2d73636f7265732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/maxalmonte14/nfl-scores)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/07d290e8c9207fa6c4fd454085872aaeda4444cba81d0d9b6f680d41fa7b4f21/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6d6178616c6d6f6e746531342f6e666c2d73636f7265732f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/maxalmonte14/nfl-scores/?branch=master)[![Code Coverage](https://camo.githubusercontent.com/1086391c9e40c914a28bc2e839f9e5acc2dd112fab834ea9c53fe7b9b81a8830/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6d6178616c6d6f6e746531342f6e666c2d73636f7265732f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/maxalmonte14/nfl-scores/?branch=master)[![Build Status](https://camo.githubusercontent.com/9612d4416797813cb8ebe85ff0b01b74000fcbe76997bd20f789ca23d589fd60/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6d6178616c6d6f6e746531342f6e666c2d73636f7265732f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/maxalmonte14/nfl-scores/build-status/master)[![StyleCI](https://camo.githubusercontent.com/b6afe18ca4516c3beba8117f2e11dafaad944dc16a15778098deba501af5c55b/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3134383935303835342f736869656c643f6272616e63683d6d6173746572)](https://github.styleci.io/repos/148950854)[![License: MIT](https://camo.githubusercontent.com/08cef40a9105b6526ca22088bc514fbfdbc9aac1ddbf8d4e6c750e3a88a44dca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e737667)](https://opensource.org/licenses/MIT) NFL-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. Requirements ------------ [](#requirements) ``` PHP >= 7.1.3 ``` Installation ------------ [](#installation) ``` composer require "maxalmonte14/nfl-scores" ``` How to use ---------- [](#how-to-use) ### Getting all live games [](#getting-all-live-games) ``` php nfl-scores live ``` That will show you something like this. ``` BAL VS BUF @ M&T Bank Stadium 3rd Quarter | 13:48 | BAL 1st & 10 +-----+----+----+---+---+----+----+ | | 1 | 2 | 3 | 4 | OT | T | +-----+----+----+---+---+----+----+ | BAL | 14 | 12 | 0 | 0 | 0 | 26 | | BUF | 0 | 0 | 0 | 0 | 0 | 0 | +-----+----+----+---+---+----+----+ CLE VS PIT @ FirstEnergy Stadium 3rd Quarter | 08:24 | PIT 1st & 10 +-----+---+---+---+---+----+----+ | | 1 | 2 | 3 | 4 | OT | T | +-----+---+---+---+---+----+----+ | CLE | 0 | 0 | 7 | 0 | 0 | 7 | | PIT | 0 | 7 | 7 | 0 | 0 | 14 | +-----+---+---+---+---+----+----+ ``` You 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? ### Getting your favorite team live game [](#getting-your-favorite-team-live-game) You can get one specific live game just passing a parameter with your team abbreviation to the `live` command. ``` php nfl-scores live CLE ``` And now you have the Cleveland Browns game live on your terminal! ``` CLE VS PIT @ FirstEnergy Stadium 3rd Quarter | 08:24 | PIT 1st & 10 +-----+---+---+---+---+----+----+ | | 1 | 2 | 3 | 4 | OT | T | +-----+---+---+---+---+----+----+ | CLE | 0 | 0 | 7 | 0 | 0 | 7 | | PIT | 0 | 7 | 7 | 0 | 0 | 14 | +-----+---+---+---+---+----+----+ ``` ### Getting a list of today's games [](#getting-a-list-of-todays-games) If you want to see what teams are going to play today you can use the `today` command. ``` php nfl-scores today ``` That will show an output as the following. ``` +------+---------+-------------------------------+------------+-------------+ | Home | Visitor | Stadium | Date | Hour | +------+---------+-------------------------------+------------+-------------+ | ATL | NO | Mercedes-Benz Stadium | 09/23/2018 | 13:00:00 ET | | LA | LAC | Los Angeles Memorial Coliseum | 09/23/2018 | 16:05:00 ET | | ARI | CHI | State Farm Stadium | 09/23/2018 | 16:25:00 ET | | SEA | DAL | CenturyLink Field | 09/23/2018 | 16:25:00 ET | | DET | NE | Ford Field | 09/23/2018 | 20:20:00 ET | | BAL | DEN | M&T Bank Stadium | 09/23/2018 | 13:00:00 ET | | CAR | CIN | Bank of America Stadium | 09/23/2018 | 13:00:00 ET | | HOU | NYG | NRG Stadium | 09/23/2018 | 13:00:00 ET | | JAX | TEN | TIAA Bank Field | 09/23/2018 | 13:00:00 ET | | KC | SF | Arrowhead Stadium | 09/23/2018 | 13:00:00 ET | | MIA | OAK | Hard Rock Stadium | 09/23/2018 | 13:00:00 ET | | MIN | BUF | U.S. Bank Stadium | 09/23/2018 | 13:00:00 ET | | PHI | IND | Lincoln Financial Field | 09/23/2018 | 13:00:00 ET | | WAS | GB | FedExField | 09/23/2018 | 13:00:00 ET | +------+---------+-------------------------------+------------+-------------+ ``` ### Getting today's finished games [](#getting-todays-finished-games) The `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. ``` php nfl-scores finished ``` The output will be like the following: ``` PHI VS ATL @ Lincoln Financial Field +-----+---+---+---+---+----+----+ | | 1 | 2 | 3 | 4 | OT | T | +-----+---+---+---+---+----+----+ | PHI | 0 | 3 | 7 | 8 | 0 | 18 | | ATL | 3 | 3 | 0 | 6 | 0 | 12 | +-----+---+---+---+---+----+----+ BAL VS BUF @ M&T Bank Stadium +-----+----+----+----+---+----+----+ | | 1 | 2 | 3 | 4 | OT | T | +-----+----+----+----+---+----+----+ | BAL | 14 | 12 | 14 | 8 | 0 | 47 | | BUF | 0 | 0 | 3 | 0 | 0 | 3 | +-----+----+----+----+---+----+----+ ``` You can also get one specific game passing a parameter to the `finished` command. ``` php nfl-scores finished PHI ``` The output will be like the following: ``` PHI VS ATL @ Lincoln Financial Field +-----+---+---+---+---+----+----+ | | 1 | 2 | 3 | 4 | OT | T | +-----+---+---+---+---+----+----+ | PHI | 0 | 3 | 7 | 8 | 0 | 18 | | ATL | 3 | 3 | 0 | 6 | 0 | 12 | +-----+---+---+---+---+----+----+ ``` ### Getting the games for this week [](#getting-the-games-for-this-week) The `week` command will show the games for the current week. ``` php nfl-scores week ``` > **Note**: Remember, a week in the NFL is composed by a Thursday, a Sunday and the Monday of next week. The output will be similar to the following. ``` +------+---------+-------------------------------+------------+-------------+ | Home | Visitor | Stadium | Date | Hour | +------+---------+-------------------------------+------------+-------------+ | ATL | NO | Mercedes-Benz Stadium | 09/23/2018 | 13:00:00 ET | | LA | LAC | Los Angeles Memorial Coliseum | 09/23/2018 | 16:05:00 ET | | ARI | CHI | State Farm Stadium | 09/23/2018 | 16:25:00 ET | | SEA | DAL | CenturyLink Field | 09/23/2018 | 16:25:00 ET | | DET | NE | Ford Field | 09/23/2018 | 20:20:00 ET | | BAL | DEN | M&T Bank Stadium | 09/23/2018 | 13:00:00 ET | | CAR | CIN | Bank of America Stadium | 09/23/2018 | 13:00:00 ET | | HOU | NYG | NRG Stadium | 09/23/2018 | 13:00:00 ET | | JAX | TEN | TIAA Bank Field | 09/23/2018 | 13:00:00 ET | | KC | SF | Arrowhead Stadium | 09/23/2018 | 13:00:00 ET | | MIA | OAK | Hard Rock Stadium | 09/23/2018 | 13:00:00 ET | | MIN | BUF | U.S. Bank Stadium | 09/23/2018 | 13:00:00 ET | | PHI | IND | Lincoln Financial Field | 09/23/2018 | 13:00:00 ET | | WAS | GB | FedExField | 09/23/2018 | 13:00:00 ET | | TB | PIT | Raymond James Stadium | 09/24/2018 | 20:15:00 ET | | CLE | NYJ | FirstEnergy Stadium | 09/20/2018 | 20:20:00 ET | +------+---------+-------------------------------+------------+-------------+ ``` What this program cannot do --------------------------- [](#what-this-program-cannot-do) This 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. For that reason this program cannot do the following things: - Show information about games played before the current NFL week. - Show player stats, because they're not contained in the JSON file. What this program doesn't do but could do! ------------------------------------------ [](#what-this-program-doesnt-do-but-could-do) There is a lot of things that I would love to add in future versions of this program, these are some of them: - Show the output in a prettier way. Everybody loves nice things! - 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. - Show notifications every time a team scores or the game is finished. - Store passed games in a database. What this program can improve ----------------------------- [](#what-this-program-can-improve) There is a lot of things that can be done to improve this program, there are a few of them: - Refactor! Everything turns better when you refactor it. - 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. - Speed up. Everybody loves fast things. Contributing ------------ [](#contributing) Do 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. ### Health Score 29 — LowBetter than 60% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity14 Limited adoption so far Community8 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~8 days Total 7 Last Release 2748d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/813e041671ebc0668cdc0280245483d16775a3ae2ba202632d0235be3f3faec1?d=identicon)[maxalmonte14](/maintainers/maxalmonte14) --- Top Contributors [![maxalmonte14](https://avatars.githubusercontent.com/u/12385704?v=4)](https://github.com/maxalmonte14 "maxalmonte14 (59 commits)") --- Tags cliconsolefootballnflphpphp7sportsterminaltoolcliterminalsportsfootballnfl ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/maxalmonte14-nfl-scores/health.svg) ``` [![Health](https://phpackages.com/badges/maxalmonte14-nfl-scores/health.svg)](https://phpackages.com/packages/maxalmonte14-nfl-scores) ``` ### Alternatives [symfony/console Eases the creation of beautiful and testable command line interfaces 9.8k1.1B11.3k](/packages/symfony-console)[league/climate PHP's best friend for the terminal. CLImate allows you to easily output colored text, special formats, and more. 1.9k14.0M273](/packages/league-climate)[php-school/cli-menu A command line menu helper in PHP 2.0k1.1M27](/packages/php-school-cli-menu)[php-tui/php-tui Comprehensive TUI library heavily influenced by Ratatui 589747.0k6](/packages/php-tui-php-tui)[aplus/cli Aplus Framework CLI Library 2301.7M6](/packages/aplus-cli)[splitbrain/php-cli Easy command line scripts for PHP with opt parsing and color output. No dependencies 177817.2k28](/packages/splitbrain-php-cli) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)