# PDFcut

**Repository Path**: chy2948331536/pdfcut

## Basic Information

- **Project Name**: PDFcut
- **Description**: 裁减pdf周围空白
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-31
- **Last Updated**: 2025-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# pdfcut

Trim white margins from PDF pages and keep a specified margin. Provides a command line `pdfcut`.

## Install (editable or user install)

Inside the project directory:

```bash
# Option A: install to current environment
pip install -e .

# Option B: install to user site-packages (no edit)
pip install .
```

If you prefer isolation and easy global usage:

```bash
# With pipx (recommended for CLI tools)
pipx install .
```

## Usage

```bash
# basic
pdfcut input.pdf

# custom output and margins (mm)
pdfcut input.pdf -o output.pdf --margin-mm 5

# tune sensitivity and render scale
pdfcut input.pdf --threshold 245 --scale 2.0
```

## Notes
- Requires Python 3.8+.
- Depends on PyMuPDF (`fitz`) and Pillow.
- The command name is `pdfcut` to avoid conflict with Unix `cut`.