Metadata-Version: 2.4
Name: betteria
Version: 0.1.2
Summary: A commandline tool to enhance PDFs from Internet Archive.
Requires-Python: >=3.9.0
Requires-Dist: img2pdf>=0.6.0
Requires-Dist: opencv-python>=4.11.0.86
Requires-Dist: pdf2image>=1.17.0
Requires-Dist: pillow>=11.2.1
Requires-Dist: rich>=13.9.4
Provides-Extra: dev
Requires-Dist: maturin; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Description-Content-Type: text/markdown

# betteria

[![PyPI version](https://badge.fury.io/py/betteria.svg)](https://badge.fury.io/py/betteria)

A commandline tool to enhance PDFs from Internet Archive.

## Installation

```bash
pip install betteria
```

## Usage

```bash
betteria --help
```

    usage: betteria [-h] --input INPUT [--output OUTPUT] [--dpi DPI] [--threshold THRESHOLD] [--block-size BLOCK_SIZE] [--c-val C_VAL] [--adaptive]
                    [--invert] [--quiet] [--jobs JOBS] [-v]

    Clean and compress a scanned PDF by whitening pages and saving as CCITT Group 4 TIFFs (via a manual page-by-page approach).

    options:
    -h, --help            show this help message and exit
    --input INPUT         Path to input PDF
    --output OUTPUT       Path to output PDF (default: <input-stem>-enhanced.pdf)
    --dpi DPI             DPI for rasterizing PDF pages (default: 150)
    --threshold THRESHOLD
                            Global threshold value (0-255)
    --block-size BLOCK_SIZE
                            Odd-sized neighborhood for adaptive thresholding (default: 31)
    --c-val C_VAL         Constant subtracted in adaptive thresholding (default: 15)
    --adaptive            Use adaptive thresholding instead of a global threshold (default: on)
    --invert              Invert pixels before thresholding (for light text on dark background, default: off)
    --quiet               Disable progress bars (default: show progress)
    --jobs JOBS           Parallel workers for rasterizing and whitening ('auto'/0 uses logical cores; use 1 to disable)
    --rasterizer RASTERIZER
                          Poppler rasterizer to use ('pdftoppm' or 'pdftocairo') (default: pdftocairo)
    -v, --version         show program's version number and exit
