ocrgrep

A grep-like OCR tool for image, video and document files, utilizing the fast and accurate Chrome Screen AI engine via locro.

$ ocrgrep -ih 'grep-like' screenshot.png    
rep README.md in main Preview ocrgrep A grep-like OCR tool for image and video files, uti

usage: ocrgrep    [-i] [-m NUM] [-p] [-r] [-w NUM] [-C NUM] [-F] [-h] [-t] [--include GLOB] [--exclude GLOB]
                  [--no-image] [--no-video] [--no-document] [--video-max-msec NUM] [--video-step-msec NUM]
                  [--help]
                  pattern files [files ...]

positional arguments:
  pattern
  files

options:
  -i, --ignore-case     ignore case distinctions in patterns and data
  -m, --max-count NUM   stop scanning file after NUM matches
  -p, --progress        show progress bar
  -r, --recursive       scan subfiles in directories
  -w, --workers NUM     concurrency
  -C, --context NUM     print NUM characters of output context (default: 40)
  -F, --fixed-strings   PATTERN is a string
  -h, --no-filename     suppress the file name prefix on output
  -t, --no-info         suppress extra info for matches (video timestamp, document page number)
  --include GLOB        search only files that match GLOB (a file pattern)
  --exclude GLOB        skip files that match GLOB
  --no-image            skip image files
  --no-video            skip video files
  --no-document         skip document files
  --video-max-msec NUM  stop after NUM milliseconds of video
  --video-step-msec NUM
                        scan a frame for every NUM milliseconds of video (default: 1000)
  --help                show this help message and exit

Install

pip install git+https://github.com/sergiocorreia/clv-locro.git@ba53ee24ee649e39c23daee3c8e9bec946642743
locro download
pip install ocrgrep

Development Status
- 4 - Beta
Environment
- Console
Intended Audience
- End Users/Desktop
License
- OSI Approved :: MIT License
Natural Language
- English
Operating System
- OS Independent
Programming Language
- Python
Topic
- Utilities

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ocrgrep-0.2.1.tar.gz (5.8 kB view details)

Uploaded Aug 19, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ocrgrep-0.2.1-py3-none-any.whl (6.8 kB view details)

Uploaded Aug 19, 2026 Python 3

File details

Details for the file ocrgrep-0.2.1.tar.gz.

File metadata

Download URL: ocrgrep-0.2.1.tar.gz
Upload date: Aug 19, 2026
Size: 5.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ocrgrep-0.2.1.tar.gz
Algorithm	Hash digest
SHA256	`974f38ced4129fcfcb6f80164f84a34e09c4c386e4ea4ea8ff0419f51394c7db`
MD5	`a0f6e9a3a09568a8c8c4380eeadcab78`
BLAKE2b-256	`5a28e5f569ea85d365d2ed10f1f994f44f4df8db38303c0f45dc501b8ec046d4`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ocrgrep-0.2.1.tar.gz:

Publisher: publish.yml on tmctmt/ocrgrep

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ocrgrep-0.2.1.tar.gz
- Subject digest: 974f38ced4129fcfcb6f80164f84a34e09c4c386e4ea4ea8ff0419f51394c7db
- Sigstore transparency entry: 2510330797
- Sigstore integration time: Aug 19, 2026
Source repository:
- Permalink: tmctmt/ocrgrep@72b398b21cc8a854be9136a247fdc2cd8acd6725
- Branch / Tag: refs/tags/0.2.1
- Owner: https://github.com/tmctmt
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@72b398b21cc8a854be9136a247fdc2cd8acd6725
- Trigger Event: release