Project

DataBall

Sports Data & Simulator (CLI)

Overview

A command‑line tool that downloads, stores, displays, and simulates football matches using public APIs. Keeps a local SQLite database, shows a 3‑day dashboard (yesterday/today/tomorrow) grouped by league, and exports data to Excel. Perfect for football analysts, bettors, or fans who want to track fixtures and results offline.

Key Features

  • Data Download: Fetch fixtures for any date range (day, week, month, or custom) from a public football API.
  • SQLite Storage: Efficiently store and query matches, teams, and leagues.
  • 3‑Day Dashboard: Automatically shows yesterday/today/tomorrow matches grouped by league with coloured scores.
  • League Flags: Visual emoji flags for Premier League, La Liga, Serie A, Brasileirão, and Champions League.
  • Excel Export: Export any date range to a `.xlsx` file with full match details.
  • Match Simulation: Basic simulation logic to predict match outcomes (WIP).

Technologies

Python REST API SQLite Tabulate openpyxl Requests

Links

DataBall is a command‑line tool with no public web interface. Check the GitHub repo for installation and usage instructions.