#:soccer:Live Football Stats & Game Links:tv:

Python web-scraper that automatically retrieves the latest stats for major Football leagues and working streams for live games and game highlights directly from your terminal.

Leagues Available: Premier League, La Liga, Serie A, Ligue 1, Bundesliga (Add more to your liking!)
Competitions: Champions League
Stats: Top Scorers (All leagues & competitions)
Video: Live streams & Full game highlights

##Who Is It For? Anyone who wants to find Football information quickly, without a hassle and most importantly without ADs!👍
I always like to stay up to date with game scores, details and watching highlights but I hate having to search through a lot of different websites to find what I need.

##How To Install? Use pip to install
Football-CLI runs the program directly from your terminal

1. Open your terminal and type:

$pip install Football-CLI                  #pip3 install Football-CLI   <-use this if your default framework is python 2
$Football-CLI                              #This will automatically run the program!

➡️ Link to Latest Package Release on Pypi: [Football-CLI-1.1.4](https://pypi.python.org/pypi/Football-CLI/1.1.4)

##Content

• Description
• How to install
• Functionalities
  • Standings, Match Scores, Top Scorers, Champions League, Live Streams, Highlights, Fixtures, Live Stats
  • How it works
• Dependencies

##What It Does

###Standings Up-to-date leagues and competitions standings: ![alt text] (https://github.com/jctissier/Football-CLI/blob/master/Documentation/Standings.gif "Standings for Football Leagues & Champions League")

###Match Scores Game date, final score and game details such as goal scorers, assists and time scored:
![alt text] (https://github.com/jctissier/Football-CLI/blob/master/Documentation/MatchScores.gif "Match details for each Football Leagues")

###Top Scorers Top scorers for all leagues available: ![alt text] (https://github.com/jctissier/Football-CLI/blob/master/Documentation/TopScorers.gif "Top Scorers for each Football Leagues")

###Champions League Standings, Match Scores and Top Scorers for the Champions League competition:

• Group Stage Standings: Up-to-date standings for the group stage
• Group Stage Results: Match scores and details for each Champions League game week
• Resuts by Group: Match scores and details for each Group A-H
• Top Scorers: Champions League top scorers for the whole competition

 

###Live Streams Finds live games that can be watched (Requires an active Reddit account):

• Search input must include one of the team names (ex: Barcelona) or it will redirect you back to the Main Menu
• Case Insensitive
• Command + Double click on link - Open link in browser from terminal

![alt text] (https://github.com/jctissier/Football-CLI/blob/master/Documentation/Football-Live%20Streams.gif "Find WORKING links to live streams")

###Highlights List of highlights from all competitions:

• Search input must include one of the team names (ex: Barcelona) or it will redirect you back to the Main Menu
• Case Insensitive
• These highlights do have ads but the quality is perfect and always reliable, 10 seconds in the beginning + 10 seconds if video is longer than 4 minutes
• Command + Double click on link - Open link in browser from terminal
• I have formatted the titles to make it more convenient, the format is:
• [League/Competition Name] [Date of Game] [Team 1 vs. Team 2]

![alt text] (https://github.com/jctissier/Football-CLI/blob/master/Documentation/Highlights.gif "League/Competition Football Highlights")

###How It works Navigating through the Main Menu is easy:

• Enter the number assigned to the menu you want to navigate to and press 'Enter'


• Example: I want to see the Standings for Liga BBVA

1. Main Menu > Press 1 and 'Enter'
2. Choose Liga BBVA > Press 2 and 'Enter'

You may only choose the numbers assigned in the menu, otherwise the menu will reload 

##Dependencies This CLI is for Python 3 and Mac OS X platform, will work on making it available for Windows & Linux as well as Python 2

5 main packages are used:

1. Praw
   
   1. Used to scrape Reddit, Used to find links for Live Streams and Highlights
2. Requests
   
   1. Use with Beautiful Soup to scrape ca.soccerway.com website
3. Termcolor
   
   1. Used to print text in color (make it nice to look at)
4. Beautifulsoup4
   
   1. Fast way of webscraping and printing data to the terminal
5. Lxml
   
   1. Fast and easy-to-use library for scraping HTML

##Final Notes Author: Jean-Claude Tissier
Feel free to contribute or request new features and leave an issue if you have any problems/questions!

No API Key needed! All data is scraped from ca.soccerway.com, The Guardian and Subreddits, Soccerstreams & Footballhighlights.