Skip to main content

Screen OCR

PyPI Changelog Tests License

The screen-ocr package makes it easy to perform OCR on portions of the screen.

Installation

Choose one of the following backends and follow the steps. WinRT is recommended for Windows and Tesseract for all other platforms.

WinRT

WinRT is a Windows-only backend that is very fast and reasonably accurate. To install screen-ocr with WinRT support, run pip install screen-ocr[winrt]

Tesseract

Tesseract is a cross-platform backend that is much slower and slightly less accurate than WinRT. To install screen-ocr with Tesseract support:

  1. Install Tesseract binaries. For Windows, see https://github.com/UB-Mannheim/tesseract/wiki.
  2. pip install screen-ocr[tesseract]

EasyOCR

EasyOCR is a very accurate but slow backend and only runs on Python 64-bit, and hence is considered experimental. To install screen-ocr with WinRT support, run pip install screen-ocr[easyocr]

Usage

You can do a simple test by running python -m screen_ocr to OCR the current screen contents. See __main__.py for the code.

If using Tesseract with a custom installation directory on Windows, set tesseract_data_path and tesseract_command paths appropriately when constructing a Reader instance.

See also gaze-ocr for more a more involved usage example.

Metadata

Release files for screen-ocr 0.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for screen-ocr 0.7.0
File Size Uploaded
screen_ocr-0.7.0.tar.gz 83.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for screen-ocr 0.7.0
File Interpreter ABI Platform
screen_ocr-0.7.0-py3-none-any.whl Python 3 none any Details

Total release size: 102.4 kB

Release files / screen_ocr-0.7.0.tar.gz

Download URL screen_ocr-0.7.0.tar.gz
Size 83.0 kB
Tags Source
SHA-256 checksum
How to use checksums
5604ea74f1e00039d9fb13c4074ffa97fa93d223dfed684be1b0116e0f99f937
BLAKE2b-256 checksum
How to use checksums
ca8b8c6fdfd8a2f50de39975b84dbd95fbc98f7373fef6852b05b51d7b7544e3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 30, 2025.

Transparency log

Release files / screen_ocr-0.7.0-py3-none-any.whl

Download URL screen_ocr-0.7.0-py3-none-any.whl
Size 19.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
68dbfa036c143f02b371e22567b623f3badf463428c75566f167de6f323dd159
BLAKE2b-256 checksum
How to use checksums
8f019754265c6fc4db0e551cc9546cc9059a88eac10b3be21cfd2028d09a9895
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 30, 2025.

Transparency log

Release history Release notifications | RSS feed

This release

0.7.0 This release

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.1

2 release files

0.1.0

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page