Skip to content

PlayerTracker is an innovative platform πŸš€ that uses artificial intelligence πŸ€– to automatically detect players ⚽ and generate advanced statistics πŸ“Š from futsal match videos πŸŽ₯.

License

Notifications You must be signed in to change notification settings

n4wf3l/PlayerTracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

0332072 Β· Mar 2, 2025

History

8 Commits
Mar 1, 2025
Mar 1, 2025
Mar 2, 2025
Mar 1, 2025

Repository files navigation

PlayerTracker πŸ†πŸ“Š

πŸš€ AI-powered player tracking and automated statistics for futsal

πŸ“Œ Introduction

PlayerTracker is an innovative platform that uses artificial intelligence to automatically detect players and generate advanced statistics from futsal match videos.

Designed for data analysts, coaches, and clubs, PlayerTracker provides an automated and intuitive way to track team performances, offering valuable insights without requiring manual intervention.

This project was developed for commercial purposes and was also used as a final-year academic project in software engineering.


πŸ”₯ Key Features

🏟 Automated Match Analysis

  • Player detection from match videos πŸŽ₯
  • Automatic generation of game statistics πŸ“Š
  • Identification of key events (goals, passes, shots, possession) ⚽

πŸŽ› Dashboard & Statistics

  • Recent matches analysis at a glance
  • Performance comparison across multiple matches
  • Dynamic visual analytics, including:
    • Goal ratio per match
    • Possession rate
    • Heatmaps for player and ball movements πŸ”₯

πŸš€ Match & Team Management

  • Upload matches (video files must meet specific requirements)
  • Edit match details (team names, date, etc.)
  • Export match reports as PDFs πŸ“„
  • Add and manage team players & coaching staff πŸ‘₯
  • Team Management page to set up club details

πŸ” Security & User Management

  • Secure authentication system πŸ”‘
  • Role-based access (analyst, admin)
  • Multi-user support (add staff members to a team)

πŸ›  Tech Stack

PlayerTracker leverages a modern full-stack architecture, combining a powerful backend, an intuitive frontend, and AI-driven analytics.

πŸ— Backend

  • Adonisjs – API development
  • MinIO – Object storage for video processing
  • PostgreSQL - Data storing

🎨 Frontend

  • React – React-based frontend with client-side rendering
  • TailwindCSS – Clean and responsive UI design

πŸ€– Artificial Intelligence

  • YOLOv11 (You Only Look Once) – Player & ball detection
  • OpenCV – Video & image processing
  • Roboflow – AI model labeling & optimization

Deployment

  • Docker - Containerization

πŸ“‚ Installation & Deployment

1️⃣ Prerequisites

Ensure you have the following installed:

  • Node.js (v16+) and npm (or yarn)
  • Docker & Docker Compose (recommended)
  • MinIO (for video storage)
  • FFmpeg (for video processing)

πŸ† How to Use PlayerTracker?

1️⃣ Create an Account & Login

Users sign up and log into their secure dashboard.

2️⃣ Upload a Match

  • Go to the Uploader page
  • Enter match details (teams, date, etc.)
  • Select a video file and click Upload
  • AI automatically analyzes the match 🧠

3️⃣ Analyze Match Statistics

  • View all generated statistics on the Statistics page πŸ“Š
  • Compare performance across matches
  • Explore dynamic charts & heatmaps πŸ”₯

4️⃣ Export Reports

  • Match reports can be exported as PDFs πŸ“„

5️⃣ Manage Team & Staff

  • Add/edit players & coaching staff πŸ‘₯
  • Customize club details πŸ“‹

image image image image image image


🌍 Roadmap & Future Developments

βœ… MVP available with core features πŸŽ‰
πŸ”œ Upcoming Enhancements:
➜ Pass tracking 🎯
➜ Advanced analytics on shots, goals & duels ⚽
➜ Player ID tracking for individual performance monitoring πŸ”
➜ Enhanced AI models for improved accuracy πŸ€–


πŸ’Ό Business Opportunities

We are open to:
βœ… Collaborations with futsal clubs & federations
βœ… Investment opportunities to expand & enhance the platform
βœ… Acquisition of the MVP and concept under specific conditions

πŸ“© If you’re interested, feel free to reach out to us!


πŸ”’ Security & Confidentiality

  • The full source code remains private within our GitHub organization.
  • No API keys or sensitive data are shared in this repository.
  • LICENSE.md ensures intellectual property protection.

πŸ“’ If we decide to release an open-source version, only selected non-critical components will be public.


πŸ“ Contributors

  • Nawfel Ajari – Project Manager
  • Kristian Vasiaj – Fullstack, AI Specialist
  • Ismael Bouzrouti – Backend, Devops & AI Specialist
  • Mehdi Merkachi – Fullstack & Performance Optimization
  • Soufiane Hamoumi – Frontend & UX/UI

The analysis phase of PlayerTracker began in October 2024. The contributors worked on this project across five different sprints between February and March 2025, following the Scrum methodology combined with Kanban for task management and workflow optimization.

A huge thank you to everyone contributing to PlayerTracker! πŸš€


πŸ“ž Contact & Support

πŸ“§ Email: info@nainnovations.be
πŸ”— GitHub: n4wf3l


πŸš€ PlayerTracker - AI-powered performance tracking for futsal! πŸ†πŸ“Š

About

PlayerTracker is an innovative platform πŸš€ that uses artificial intelligence πŸ€– to automatically detect players ⚽ and generate advanced statistics πŸ“Š from futsal match videos πŸŽ₯.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published