https://github.com/thiswillbeyourgithub/ocr_with_format
Wrapper around pytesseract to postprocess in a way that preserves spacing and formattings.
https://github.com/thiswillbeyourgithub/ocr_with_format
Last synced: 14 days ago
JSON representation
Wrapper around pytesseract to postprocess in a way that preserves spacing and formattings.
- Host: GitHub
- URL: https://github.com/thiswillbeyourgithub/ocr_with_format
- Owner: thiswillbeyourgithub
- License: agpl-3.0
- Created: 2023-07-25T14:22:31.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-01-16T09:23:14.000Z (about 1 month ago)
- Last Synced: 2026-01-16T23:46:00.068Z (about 1 month ago)
- Language: Python
- Size: 202 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# OCR_with_format
* simple wrapper that postprocesses pytesseract's hOCR output to maintain format and spacings.
* [Link to an alternative implementation found on stackoverflow](https://stackoverflow.com/questions/59582008/preserving-indentation-with-tesseract-ocr-4-x)
## How to
* install `python -m pip install OCR_with_format`
* see usage `OCR_with_format --help` (executing with `python -m` is not supported)
## Usage
```
NAME
OCR_with_format
SYNOPSIS
OCR_with_format IMG_PATH
POSITIONAL ARGUMENTS
IMG_PATH
Type: str
path to the image you want to do OCR on
FLAGS
-m, --method=METHOD
Type: str
Default: 'with_format'
if 'with_format', will use the author's code if 'none', will output tesseract's default output if 'stackoverflow', will output using another algorithm found on stackoverflow
--thresholding_method=THRESHOLDING_METHOD
Type: str
Default: 'otsu'
any from "otsu", "otsu_gaussian", "adaptative_gaussian", "all"
If "all", the three methods will be tried and the final output will be the one which maximizes the mean and median confidences over each parsed words.
-l, --language=LANGUAGE
Type: str
Default: 'eng'
language to look for in the image
-o, --output_path=OUTPUT_PATH
Type: Optional[str]
Default: None
if not None, will output to this path and erase its previous content.
--tesseract_args=TESSERACT_ARGS
Type: str
Default: '-...
default arguments for tesseract
-q, --quiet=QUIET
Default: False
if True, will only print the output and no logs
NOTES
You can also use flags syntax for POSITIONAL ARGUMENTS
```
## Example
* Image:
* 
* output from `OCR_with_format ./screenshot.png --thresholding_method="all" --quiet`
```
@Unwateh (1) ~ Fork (3) (©
OCR_with_format [ Pir ][ | [ & <) [ s -]
About
&
Wrapper around pytesseract to
¥ Branches © Tags postprocess in a way that preserves
spacing and formattings.
i thiswillbeyourgithub addded license 10 minutes ago O 4
&5 GPL-3.0 license
@ LICENSE addded license 10 minutes ago - Activity
[u] __init__.py minor 11 minutes ago ¢ Ostars
[u] requirements.txt added empty requirements 11 minutes ago <& 1 watching
Y Oforks
Help people interested in this repository understand your project by
adding a README. Releases
Create No releases a new published release
Packages
No packages published
Publish your first package
Languages
———
® Python 100.0%
```
* output from `OCR_with_format ./screenshot.png --quiet --comparison_run`
*
```
OCR_with_format
[ pin | [ @unwateh (@) ~ | [ & Fork (O)
-] [ ¢ s (0
¥ main ~
¥ Branches © Tags
Wrapper around pytesseract to
postprocess in a way that preserves
. . . spacing and formattings.
- thiswillbeyourgithub addded license 10 minutes ago 'O 4
&5 GPL-3.0 license
@ LICENSE addded license 10 minutes ago A Activity
0O _init__py minor 11 minutes ago ¢ Ostars
O requirements.txt added empty requirements 11 minutes ago | @ 1watching
% 0forks
Help people interested in this repository understand your project by
adding a README. Releases
No releases published
Create a new release
Packages
No packages published
Publish your first package
Languages
————
@ Python 100.0%
```