efootball-result-analyzer 0.2.2

OCR-only eFootball screenshot analyzer with scoreboard-region and card-layout detection

eFootball Result Analyzer

OCR-only eFootball screenshot analysis with dedicated support for:

• classic yellow-and-blue eFootball result screens
• penalty result screens such as 4 PK 3
• compact dark scoreboard-card screenshots

Features

• Local OCR extraction for usernames, scoreline, winner, loser, and match stats
• Explicit detection of scoreboard regions for:
  • left username or team
  • left score box
  • right score box
  • right username or team
  • penalty score band when present
• Penalty-aware result parsing
• Compact card-layout scoreline parsing
• Importable Python API
• Desktop GUI uploader
• CLI entrypoints

Install

pip install efootball-result-analyzer

You also need the native Tesseract executable installed on your machine.

Python Usage

from efootball_analyzer import analyze_match_result

result = analyze_match_result("result.jpg")

print(result["winner"], result["scoreline"])
print(result.get("penalty_scoreline"))
print(result["scoreboard_regions"])

CLI

efootball-analyze --image result.jpg
efootball-analyze --image result.jpg --team "United"
efootball-analyze --image result.jpg --username "I clear ball"
efootball-analyze-gui

Output

The analyzer returns a dictionary with fields such as:

• team1, team2
• team1_label, team2_label
• score1, score2
• winner, loser, margin
• result_type
• penalty_score1, penalty_score2, penalty_scoreline
• scoreline
• stats
• scoreboard_regions
• raw_text