pictoiso 1.0.0

Scales images to standard ISO card dimensions with blurred margins, customizable millimeter padding, and PNG output.

pictoiso

A Python CLI tool and library to symmetrically upscale, style, and fit images into the standard ISO/IEC 7810 ID-1 card dimensions (85.60mm × 53.98mm). Perfect for creating uniform printable card labels, badges, or templates.

Features

• Blurred Canvas: Scales the image to fill the background completely and applies a smooth blur filter.
• Symmetric Centering: Fits the foreground cleanly over the center without distortion.
• Lossless Export: Always outputs high-quality PNGs with embedded DPI metadata.
• Inner Image Margin: Symmetrically shrinks the foreground image by a custom millimeter value, exposing more of the blurred background around the edges.
• Batch Processing: Point the tool at a folder to convert all images automatically.

Installation

pip install pictoiso

CLI Usage

Single Image Conversion (with 4mm inner padding margin)

pictoiso photo.jpg -o output_card.png --dpi 600 --border 4.0

Batch Directory Conversion

pictoiso ./my_photos --blur 25

Arguments

• input: Path to input file or folder.
• -o, --output: Target destination (file path or folder path).
• -b, --blur: Background blur radius (default: 15).
• --dpi: Target pixel density (300 or 600).
• --border: Foreground inner padding margin in millimeters (default: 1.8).

License

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0). It is strictly free for personal and non-commercial use. Commercial use is prohibited.