Pixel Press

Pixel Press resizes images so their longest side does not exceed a maximum dimension. It keeps the aspect ratio, never enlarges images, and can process individual files, multiple files, or complete folder trees.

Install

Requires Python 3.10 or newer.

python -m pip install pixel-press

Command-line usage

Resize every supported image in a folder and its subfolders:

imgresizer --dir .\photos --max-dimension 2048 --output .\resized

The directory structure is preserved in the output directory. Images already within the limit are copied unchanged. Images larger than the limit are resized while preserving their aspect ratio.

Useful options:

--dir PATH              Input directory, including subfolders
--output PATH           Output directory (default: <input>_resized)
--max-dimension PIXELS  Maximum longest side (default: 2048)
--verbose               Show debug logging

The CLI logs each copied, resized, or skipped file and prints a final summary.

Web interface

Start the local FastAPI service:

imgresizer

Open http://127.0.0.1:8097 in a browser. The UI supports:

• One image, downloaded directly after processing
• Multiple selected images, downloaded as a ZIP
• A folder drop or folder selection, with subfolders preserved in the ZIP
• A shared maximum-dimension setting

To use another port:

imgresizer --port 9000

API

The service exposes an OpenAPI page at http://127.0.0.1:8097/docs.

Resize one image:

curl.exe -X POST http://127.0.0.1:8097/api/resize `
  -F "file=@.\photos\image.jpg" `
  -F "max_dimension=2048" `
  -o .\resized-image.jpg

Resize multiple files and receive a ZIP:

curl.exe -X POST http://127.0.0.1:8097/api/resize-folder `
  -F "files=@.\photos\one.jpg" `
  -F "files=@.\photos\two.png" `
  -F "max_dimension=2048" `
  -o .\resized-images.zip

Supported formats

JPEG, PNG, GIF, WEBP, TIFF, BMP, and ICO files are supported. Invalid or unsupported files are skipped during batch processing and reported in the logs.

License

Pixel Press is released under the MIT License.