{"id":27522665,"url":"https://github.com/fritzrehde/footy","last_synced_at":"2025-04-18T10:26:35.488Z","repository":{"id":40268068,"uuid":"410793887","full_name":"fritzrehde/footy","owner":"fritzrehde","description":"A small command line tool to get the latest football scores, fixtures and standings","archived":false,"fork":false,"pushed_at":"2022-11-28T20:11:43.000Z","size":61,"stargazers_count":6,"open_issues_count":5,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2023-03-09T23:26:01.742Z","etag":null,"topics":["bash","command-line-tool","football","shell","soccer"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/fritzrehde.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":"2021-09-27T08:00:38.000Z","updated_at":"2023-01-09T15:55:04.000Z","dependencies_parsed_at":"2022-09-13T22:40:13.478Z","dependency_job_id":null,"html_url":"https://github.com/fritzrehde/footy","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fritzrehde%2Ffooty","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fritzrehde%2Ffooty/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fritzrehde%2Ffooty/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fritzrehde%2Ffooty/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fritzrehde","download_url":"https://codeload.github.com/fritzrehde/footy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249478830,"owners_count":21279142,"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":["bash","command-line-tool","football","shell","soccer"],"created_at":"2025-04-18T10:26:34.926Z","updated_at":"2025-04-18T10:26:35.482Z","avatar_url":"https://github.com/fritzrehde.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# footy\n\n\u003ci\u003eA simple shell script that displays the latest football scores, fixtures and standings.\u003c/i\u003e\n\n[![asciicast](https://asciinema.org/a/dleQ7INJzcBYh4Q90u3UdOS9y.svg)](https://asciinema.org/a/dleQ7INJzcBYh4Q90u3UdOS9y)\n\n## Table of Contents\n\n- [Features](#features)\n- [Install](#install)\n\t- [Build from source](#build-from-source)\n- [Usage](#usage)\n\t- [Supported competitions and teams](#supported-competitions-and-teams)\n\t- [Piping output to other tools](#piping-output-to-other-tools)\n- [Dependencies](#dependencies)\n- [License](#license)\n\n## Features\n\n- **Minimalistic output**: aiming to adhere to the [Unix philosophy](https://en.wikipedia.org/wiki/Unix_philosophy), footy's output can easily be piped to other tools\n- **Portable**: minimal [dependencies](#dependencies)\n\n## Install\n\nSince footy uses the data provided by [football-data.org](https://www.football-data.org/), an api-key is required.\nYou can register for one [here](https://www.football-data.org/client/register) for free.\n\nOnce footy is installed, set the api-key by running `footy -k \u003capi-key\u003e` or manually create the file `$HOME/.config/footy/api-key.txt` containing only the api-key.  \n\n### Build from source\n```shell\ngit clone https://github.com/fritzrehde/footy.git\ncd footy\nsudo make install\n```\n\n**Note:** The makefile defaults to some default paths for installed files. Adjust to your system:\n\n- `INSTALL_DIR`: PATH for executables (default /usr/local/bin)\n\n```shell\nmake install INSTALL_DIR=/usr/bin\n```\n\n\n## Usage\n```text\nOPTIONS:\n  -s                Prints standings/table\n                    Must be used with -c \u003cCOMPETITION\u003e\n  -m \u003cDAYS+/-\u003e      Prints upcoming ('+' suffix) or previous ('-' suffix) matches\n                    Must be used with either -c \u003cCOMPETITION\u003e or -t \u003cTEAM\u003e\n  -c \u003cCOMPETITION\u003e  Specifies competition (use code or id)\n  -t \u003cTEAM\u003e         Specifies team (must use team's id)\n  -I                Prints all supported competitions\n  -i \u003cCOMPETITION\u003e  Prints all teams in competition (use code or id)\n  -r                Unformatted output for piping to other tools\n  -k \u003cAPI-KEY\u003e      Saves the api-key to $HOME/.config/footy/api-key.txt\n  -h                Prints this help message\n```\n\n### Supported competitions and teams\n`footy -I` gives you an overview of all the supported competitions (I recommend piping the output into a [pager](https://man7.org/linux/man-pages/man1/less.1.html)).\n\n`footy -i BL1` or `footy -i 2002` prints all teams in the Bundesliga using either the *Code* `BL1` or the *Id* `2002`.\n\nSome competitions do not have a *Code* and teams never have a *Code*, so you will have to use the *Id* there.\n\n**Note**: Access to some of the smaller competitions/teams is paid ([pricing](https://www.football-data.org/coverage)). Therefore, the *Price* column shows which competitions are free.\n\n### Piping output to other tools\n\nThe `-r` option provides unformatted output, where the columns are seperated by commas instead of whitespaces and the match dates are in the ISO-8601 UTC format.\n\n#### Example\n```\nfooty -s -c BL1 -r | cut -d ',' -f 1-6,10 | column -ts ','\n```\nThis command will only display the first six and the tenth column of the standings output.\n\n## Dependencies\n\n- [`jq`](https://github.com/stedolan/jq): JSON processor\n\n## License\n\nThe MIT License © Fritz Rehde\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffritzrehde%2Ffooty","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffritzrehde%2Ffooty","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffritzrehde%2Ffooty/lists"}