Practistics Scrim OCR

Practistics is an open-source OCR tool designed to capture and analyze VALORANT private scrim matches. It automatically extracts data from match scoreboards, summaries, and timelines, converting them into structured CSV data for analysis.

Before using Practistics, please ensure:

• Display Resolution: Your display must be set to 1920x1080 (native resolution).
• Match Access: Practistics is designed to work only with matches accessed from your own match history or post-scrim.
• Character Support: Player names with non-Latin characters (Chinese, etc.) may not be accurately recognized by the OCR engine.

Key Cheat-Sheet

• S on match summary screen
• B on scoreboard
• P on each round timeline
• Q when finished

How to use:

Quick Start

For a more detailed guide please refer: Installation Guide

1. Install Python 3.11 from the Python website

2. Download and unzip Practistics

3. Choose your installation path:

   CPU Installation (Standard):

   pip install -r requirements.txt
   

   GPU Installation (NVIDIA CUDA - Recommended for faster processing):

   pip install -r requirements.txt
   pip install --force-reinstall -r requirements-cuda.txt
   

   Requires CUDA Toolkit 12.4 to be installed first

4. Run the tool with the python main.py command.

5. Find your data in Documents/practistics/matches/

Documentation

• Installation Guide - Getting started with Practistics (includes GPU setup)
• Understanding the Data - Complete data points documentation
• Practical Usage Guide - Making the most of your scrim data
• Technical Documentation - Under the hood details

Why Practistics?

Traditional scrim reviews often miss the subtle patterns that emerge across multiple matches. Practistics captures these patterns by converting match data into structured formats, allowing teams to:

• Track performance trends across multiple scrims
• Analyze round-specific strategies and outcomes
• Identify patterns in economy management and site control
• Build data-driven practice routines

Project Status

This project is currently not in active development. It was created to fill the gap in accessing hidden scrim data and help teams analyze their practice matches. While functional, it's one of my earlier projects and contributions/improvements are welcome.

Support & Community

• Join our Discord server
• Follow on Twitter
• Report issues on GitHub

Contributing

Contributions are welcome! See our Contributing Guide for details.

License

This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE file for details.