A CLI tool for Fantasy Premier League
Project description
fpl-cli
fpl-cli is a command line tool for Fantasy Premier League, written in Python. The tool gets its data from the official Fantasy Premier League API, and currently supports the following actions:
fpl Returns help menu
fpl configure Set up team_id (required)
fpl points Returns live points for a team
fpl leagues Returns all leagues for a team entry
fpl league <id> Returns confirmed scores for a league by id
fpl liveleague <id> Returns live scores for a league by id
fpl entry Returns information about a team entry
fpl players Returns all players in the game, sorted by total score
Installing
fpl-cli has been tested with Python versions 2.7, 3.4, 3.5, 3.6 and 3.7 on Mac and Linux, and with 3.6 and 3.7 on Windows.
In a terminal window, verify that Python and pip is available:
python --version
pip --version
If no Python/pip version is found, download Python and pip before proceeding
pip install fplcli
Using fpl-cli
Configure fpl-cli
Start using fpl-cli by telling it your team_id. You can find your team_id by going to the Points tab at https://fantasy.premierleague.com and find the number in between team/
and event/
in the url.
Get help
Get an overview of the allowed actions by typing fpl
or fpl --help
Get current points total for team
The points total and player score is updated during games based on live score data. Provisional bonus are not included yet.
Get all leagues the team is member of
Returns all leagues you participate in (Head 2 Head leagues not included yet)
Get league standings
Returns league standings for a single league. You find the league_id in the leftmost Id
column in the fpl leagues
result
Get live league standings
Returns live league standings for a single league, where all teams score are updated in real time based on live score data. This one is a separate action from the fpl league
action because it requires ~2 API calls for each team in the league and is therefore slower (~1-10 seconds depending on league size and response times from Fantasy Premier League API).
Planned features
Planned future features include:
- Include all major features from fantasy.premierleague.com
- Include H2H leagues in leagues view
- Actions that require authentication with the FPL API (Making transfers, prepare team for next Gameweek)
- Live updates of league standings during games based on new points total
- Include provisional bonus in live league and points view
- Player sorting/filtering and enriched player staticstics
- Cache API calls to improve response times, especially for live leagues
- Transfer suggestions based on form and upcoming fixture difficulty
Ideas for features or enhancements that you would like to see from fpl-cli are welcome. Please post an issue in the GitHub repository, or even better, check out the Contributing guidelines and submit a Pull Request with the suggested change.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.