pdf-watermarker 0.2.0

Add watermarks to PDF files

PDF Watermarker

Add watermarks to PDF files easily from the command line.

Installation

pip install pdf-watermarker

Usage

pdfwatermarker input.pdf -o output.pdf -t "CONFIDENTIAL"

Options

• input - Input PDF file(s) or directory (required)
• -o, --output - Output file (or directory for multiple files)
• -t, --text - Watermark text (default: CONFIDENTIAL)
• -f, --font-size - Font size (default: 80)
• --opacity - Opacity 0-1 (default: 0.15)
• -r, --rotation - Rotation angle in degrees (default: 45)
• -c, --color - Color in hex format (default: #808080)
• -p, --position - Position: center, top-left, top-right, bottom-left, bottom-right, top-center, bottom-center (default: center)
• --in-place - Overwrite input file(s)

Examples

# Basic usage
pdfwatermarker document.pdf -t "DRAFT"

# Custom color and opacity
pdfwatermarker document.pdf -t "CONFIDENTIAL" -c #FF0000 --opacity 0.3

# Bottom-right corner
pdfwatermarker document.pdf -p bottom-right -r 0

# Process multiple files
pdfwatermarker *.pdf -o watermarked/

# Process all PDFs in a directory
pdfwatermarker ./pdfs/ --in-place

Development

uv sync
uv run pdfwatermarker input.pdf

# Run tests
uv run pytest

# Run linter
uv run ruff check src/