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

[![GitHub](]( [![GitHub Workflow Status](]( [![Total downloads](]( [![GitHub release (latest by date)](]( [![Discord](](

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.


Price: FREE.


Very short video tutorials:

Additional guides:


See the releases page for downloadable executables and installers.

See the Install Guide for help with installation.

Running and Building from Source



  1. Clone the repository:
  git clone
  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


There are some extra steps for installation on Windows:

Running from source

  1. Compile the UI files into Python:

  2. Launch the application:

  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.


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


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


pyinstaller --clean --noconfirm scoresight.spec


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.


This project is released under the MIT license.


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

Business Inquiries

If you wish to contract the development team to productionize ScoreSight for your needs, please contact