printclean 1.0.0

Cleans photographed documents for improved printing

print-clean

This script helps prepare photographed documents for printing:

Before:

After:

Installation

Install Python 3.9 or higher, then run:

pip install printclean

or

pip3 install printclean

Usage

printclean path-to-image [path-to-another-image ...] [--level value] [--lang code1 code2 ...]

You can optionally specify the cleanup’s threshold value with --level. The value must be an integer between 0 and 255, inclusive. Larger values produce images with fewer filled pixels. The default is 10.

You may also provide your document’s language(s) with the --lang parameter, which may help fix the input image’s perspective. Currently, the script can only perform simple rotations.

You can find available languages and their codes here. You might need to specifically install your required language for the Tesseract OCR engine (Windows, Ubuntu, Mac OS).

The output image will be saved as a PNG file with the suffix -cleaned.