Metadata-Version: 2.4
Name: white-paper-scanner
Version: 1.0.0
Summary: A utility to automatically crop and flatten photos of documents into highly detailed scanned images.
Author-email: Anouar Manaa <anouarmanaa19@gmail.com>
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: opencv-python-headless>=4.0
Requires-Dist: numpy>=1.0

# Paper Scanner

A command-line utility to automatically transform tilted photographs of documents into perfectly flat, highly detailed scanned images.

## Features
- **Automatic Edge Detection**: Detects the four corners of a document.
- **Perspective Flattening**: Warps a tilted photo into a perfect top-down view.
- **Flat-Field Illumination Correction**: Removes harsh shadows and uneven lighting to generate a perfect white background while preserving the original ink colors and anti-aliasing of the text.
- **Auto-Upscaling**: Mathematically doubles the megapixels and applies unsharp masking so your text stays razor-sharp even when zoomed all the way in.

## Installation

```bash
pip install paper-scanner
```

## Usage

```bash
paper-scanner path/to/your/image.jpg
```

This will output a new file named `image_scanned.jpg` in the same directory.
