Format conversion | ||
---|---|---|
imgproxy works with JPEG, PNG, WebP, AVIF, JPEG XL, GIF, SVG, ICO, HEIC, BMP, TIFF, and animated GIF and WebP formats | ||
GIF to MP4 conversion to reduce animations size dramatically | ||
PDF thumbnail generation: Turn any page from a PDF file into a preview image | ||
Video thumbnail generation: Turn any frame from a video file into a preview image | ||
PSD/PSB (Photoshop Document) thumbnail generation | ||
Image processing | ||
Resizing: imgproxy can resize images to any size | ||
Resizing with a specified algorithm: linear, cubic, Lanczos3, etc. | ||
Crop and trim images | ||
Padding: add specified space around an image | ||
Extending: top up some space if the image size is less than required | ||
Rotating | ||
Flattening: fill transparent areas with a specified color | ||
Flattening with semi-transparent background | ||
Watermarking: add a logo or copyright text to images | ||
Watermarking with custom per-request watermarks: use different watermarks for different images by specifying their URLs | ||
Text watermarks: create watermarks from specified text | ||
Watermark shadow: add a shadow to the watermark to make it more visible | ||
Watermark rotating | ||
Filters: blurring, sharpening, pixelation | ||
Unsharp masking: reduce the blurriness appeared after resizing | ||
Color adjustment: saturation, contrast, brightness | ||
Color filters: monochrome, duotone | ||
Colorize: place a color overlay on the image | ||
Gradient: place a gradient overlay on the image | ||
Injecting styles to SVG: Inject custom CSS into SVG | ||
Chained processing pipelines: customize the processing order and specify multiple pipelines using a single URL | ||
Image optimization | ||
Saving with specified quality (when supported by the resulting format) | ||
Atomatically serve images in WebP/AVIF/JPEG XL format if the browser supports it (using the "Accept" header) | ||
Auto PNG quantization: automatically save PNG images in 8-bit palette mode if the source image is also an 8-bit image | ||
Stripping image metadata: purge image EXIF, XMP, IPTC and other metadata to decrease the image file size | ||
Keeping copyright: keep the copyright information when stripping metadata | ||
Stripping image's ICC profile: convert the image to sRGB and strip the ICC profile to decrease the image file size | ||
Advanced JPEG optimizations: squeeze the size of your JPEGs to the last byte without compromising on quality | ||
Advanced WebP compression options | ||
Specifying compression parameters via URL | ||
SVG minification: cleans an image of line breaks, comments, etc. | ||
Smart features | ||
Smart crop: find the best area to crop based on edges, saturation, and skin tone | ||
Advanced smart crop: find the best area to crop based image's feature points and simple face detection | ||
Object-oriented crop: detect objects in the image using AI algorithms and crop the image around them | ||
Object blurring: detect objects in the image using AI algorithms and blur them | ||
Autoquality by the result file size: select the quality at which the resulting file will not be larger than the specified size | ||
Autoquality by DSSIM: automatic quality coefficient determination to reach maximum image compression while keeping the image quality | ||
Automatic best format selection: automatically select the resulting format that provides the best compression ratio | ||
Security | ||
URL signing | ||
Source image URL encryption: hide the source image URL from the end user | ||
Authorization with the HTTP Authorization header | ||
Source image resolution restriction: protect from "zip bombs" by cancelling image processing if the source image is too large | ||
Source image file size restriction | ||
Animation frames number restriction | ||
Allowed image source restriction | ||
Source image hashsum verification | ||
URL expiration: set a time limit for the URL to be valid | ||
SVG sanitization: remove potentially dangerous content from SVG files | ||
Image sources support | ||
HTTP(S) | ||
Local files | ||
Amazon S3 and S3-compatible storages (MinIO, Cloudflare R2, Wasabi, etc.) | ||
Google Cloud Storage | ||
Azure Blob Storage | ||
OpenStack Object Storage ("Swift") | ||
Monitoring | ||
Prometheus | ||
OpenTelemetry | ||
New Relic | ||
Datadog | ||
Amazon CloudWatch | ||
Errors reporting | ||
Sentry | ||
Honeybadger | ||
Bugsnag | ||
Airbrake | ||
Miscellaneous | ||
Image info: get info about the image format, size, metadata, and more | ||
Presets: create named presets and use them as shortcuts in the URL | ||
Fallback image: if imgproxy cannot download the original image, it uses the fallback specified in the settings | ||
Per-request fallback images: specify a fallback image in the URL overriding the default one | ||
Skip processing: specify the image formats you don’t want to be processed | ||
Raw files streaming: stream raw files without any processing or checking | ||
ETag support: use HTTP protocol's ETags for more efficient caching | ||
Cookie pass-through: pass cookies from the client request to the source image server | ||
Custom source image request headers: specify HTTP headers that will be sent to the source image server | ||
Request headers pass-through: specify which HTTP headers will be passed from the client request to the source image server | ||
Custom response headers: specify HTTP headers that will be sent in the response to the client | ||
Response headers pass-through: specify which HTTP headers will be passed from the source image server response to the client |