scoresight

ScoreSight - Real-time OCR For Scoreboards, Apps, Games and more

[![GitHub](https://img.shields.io/github/license/occ-ai/scoresight)](https://github.com/occ-ai/scoresight/blob/main/LICENSE) [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/occ-ai/scoresight/build.yaml)](https://github.com/occ-ai/scoresight/actions/workflows/build.yaml) [![Total downloads](https://img.shields.io/github/downloads/occ-ai/scoresight/total)](https://github.com/occ-ai/scoresight/releases) [![GitHub release (latest by date)](https://img.shields.io/github/v/release/occ-ai/scoresight)](https://github.com/occ-ai/scoresight/releases) [![Discord](https://img.shields.io/discord/1200229425141252116)](https://discord.gg/8pG2tC923N)

ScoreSight is an OCR (Optical Character Recognition) application designed to extract text from real-time updating streams like scoreboards, applications, videos and games. It is written in Python and utilizes the following technologies:

It is the best free real-time OCR tool on planet Earth for scoreboards and games.

If you’d like to donate to help support the project, you can do so on GitHub or Patreon.

Features

Price: FREE.

Usage

Very short video tutorials:

Additional guides:

Installation

See the releases page for downloadable executables and installers.

See the Install Guide for help with installation.

Running and Building from Source

Prerequisites

Procedure

  1. Clone the repository:
  git clone https://github.com/occ-ai/scoresight.git
  1. Install the required dependencies:
  pip install -r requirements.txt

For Mac and Windows there are further dependencies in requirements-mac.txt and requirements-win.txt

  1. Create a .env file. See the contents of the file in the .github/worksflows/build.yaml file

Windows

There are some extra steps for installation on Windows:

Running from source

  1. Compile the UI files into Python:

     ./scripts/compile_ui.ps1
    
  2. Launch the application:

     python main.py
    
  3. Follow the on-screen instructions to load an image of the scoreboard and extract the text.

Build an executable

You may want to build a distributable .exe or .app or even an installer, this is possible with PyInstaller.

To build the executable run PyInstaller.

MacOS

pyinstaller --clean --noconfirm scoresight.spec -- --mac_osx

Windows

pyinstaller --clean --noconfirm scoresight.spec -- --win

Linux

pyinstaller --clean --noconfirm scoresight.spec

Contributing

Contributions are welcome! If you would like to contribute to this project, please follow these steps:

  1. Fork the repository.
  2. Create a new branch for your feature or bug fix.
  3. Make your changes and commit them.
  4. Push your changes to your forked repository.
  5. Submit a pull request.

License

This project is released under the MIT license.

Contact

If you have any questions or suggestions, feel free to leave an issue on the repository. You may also email support@scoresight.live.

Business Inquiries

If you wish to contract the development team to productionize ScoreSight for your needs, please contact info@scoresight.live.