resizebento-image

Image resizing, cropping, padding, and format conversion for Python, built with Pillow.

Built by ResizeBento.com, a collection of privacy-friendly image tools.

Install

pip install resizebento-image

Resize a file

from resizebento_image import resize_image

result = resize_image(
    "input.jpg",
    "output.webp",
    width=800,
    height=600,
    mode="crop-to-fit",
    quality=80,
)

print(result.width, result.height)

When an output path is supplied and output_format is omitted, the output format is inferred from .jpg, .jpeg, .png, or .webp.

Work with bytes

from resizebento_image import resize_image

with open("input.png", "rb") as file:
    source = file.read()

result = resize_image(
    source,
    width=1200,
    height=630,
    mode="add-padding",
    output_format="jpg",
    padding_color="#ffffff",
    quality=90,
)

with open("result.jpg", "wb") as file:
    file.write(result.data)

bytes, bytearray, BytesIO, file-like binary objects, str paths, and pathlib.Path are supported as inputs.

Resize by percentage

from resizebento_image import resize_image_by_percentage

result = resize_image_by_percentage(
    "input.png",
    50,
    "output.png",
)

Read dimensions

from resizebento_image import get_image_dimensions

dimensions = get_image_dimensions("input.webp")
print(dimensions.width, dimensions.height)

Resize modes

Formats and defaults

Input formats: JPEG, PNG, WebP.

Output formats: JPG, PNG, WebP.

Without a destination path or explicit output_format, the default output is WebP. JPG and WebP support quality from 10 to 100, with 80 as the default. PNG ignores quality.

Target dimensions range from 1 to 16,384 pixels per side, with a maximum output area of 64,000,000 pixels. Percentage resizing supports 1% to 500%.

Result

Every resize returns a ResizeResult:

result.data        # encoded image bytes
result.width
result.height
result.format      # "webp", "jpg", or "png"
result.mime_type
result.filename
result.output_path

Errors

Validation and processing failures raise ImageResizerError with a machine-readable code.

from resizebento_image import ImageResizerError, resize_image

try:
    resize_image("input.jpg", width=0, height=600)
except ImageResizerError as error:
    print(error.code)

Privacy

The package processes images locally in your Python process. It does not upload image content to ResizeBento.

For interactive browser tools, visit ResizeBento.com.

License

MIT