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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.