Skip to main content

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.

Metadata

Release files for pixel-press 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pixel-press 1.0.1
File Size Uploaded Provenance Actions
pixel_press-1.0.1.tar.gz 13.9 kB Without provenance Details for pixel_press-1.0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pixel-press 1.0.1
File Interpreter ABI Platform Actions
pixel_press-1.0.1-py3-none-any.whl Python 3 none any Details for pixel_press-1.0.1-py3-none-any.whl

Total release size: 26.5 kB

Release files / pixel_press-1.0.1.tar.gz

Download URL pixel_press-1.0.1.tar.gz
Size 13.9 kB
Tags Source
SHA-256 checksum
How to use checksums
2a0aa5ad2f19b5149a7d3d1f26f4b3cadd27a6282e4c1e23e5f383e23a81292e
BLAKE2b-256 checksum
How to use checksums
1d4be85b8bc77cded6b13791782479598e88519aa9596ca6c3b2525d98e5d242
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / pixel_press-1.0.1-py3-none-any.whl

Download URL pixel_press-1.0.1-py3-none-any.whl
Size 12.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
79815d527fe275475781a02cd74d35573d74dcccd6f2d0afc620fe4133632a53
BLAKE2b-256 checksum
How to use checksums
d69163190e483bacb4fff85b6db4951efeb9b585a0b54648edcf2c485721b683
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Security for pixel-press 1.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page