v3.26.1

Changed

• (pro) Improve monochrome and duotone processing options.

Fixed

• Fix loading log configs from local files and secret managers.
• Fix detecting HEIF images with the heix brand.
• Fix downloading source images when the image source requires a cookie challenge.
• (pro) Fix playback of videos created from animations in Google Chrome.
• (pro) Fix detecting of width and height of HEIF images that have orientation specified in EXIF.

v3.26.0

Added

• Add imgproxy.source_image_url and imgproxy.processing_options attributes to New Relic, DataDog, and OpenTelemetry traces.
• Add IMGPROXY_S3_ENDPOINT_USE_PATH_STYLE config.
• (pro) Add monochrome processing option.
• (pro) Add duotone processing option.
• (pro) Add objw gravity type.
• (pro) Add an object pseudo-class all that can be used with the obj and objw gravity types to match all detected objects.
• (pro) Add IMGPROXY_SMART_CROP_ADVANCED_MODE config.
• (pro) Add IMGPROXY_OBJECT_DETECTION_FALLBACK_TO_SMART_CROP config.
• (docker) Add a script for building Linux packages.

Changed

• Properly set the net.host.name and http.url tags in OpenTelemetry traces.
• (pro) Object detection: class names file can contain object classes' weights.

Fixed

• Fix handling # symbols in local://, s3://, gcs://, abs://, and swift:// URLs.
• Fix IMGPROXY_FALLBACK_IMAGE_HTTP_CODE value check. Allow 0 value.
• (docker) Fix loading HEIC images made with iOS 18.

v3.25.0

Add

• Add IMGPROXY_S3_ASSUME_ROLE_EXTERNAL_ID config.
• Add IMGPROXY_WRITE_RESPONSE_TIMEOUT config.
• Add IMGPROXY_REPORT_IO_ERRORS config.
• Add IMGPROXY_ARGUMENTS_SEPARATOR config.
• Add IMGPROXY_PRESETS_SEPARATOR config.
• (pro) Add support for object detection models in ONNX format.
• (pro) Add colorize processing option.
• (pro) Add IMGPROXY_WATERMARK_PREPROCESS_URL config.
• (pro) Add IMGPROXY_FALLBACK_IMAGE_PREPROCESS_URL config.

Changed

• Automatically add http:// scheme to the IMGPROXY_S3_ENDPOINT value if it has no scheme.
• Trim redundant slashes in the S3, GCS, ABS, and Swift object keys.
• Rename IMGPROXY_WRITE_TIMEOUT to IMGPROXY_TIMEOUT. The old name is deprecated but still supported.
• Rename IMGPROXY_READ_TIMEOUT to IMGPROXY_READ_REQUEST_TIMEOUT. The old name is deprecated but still supported.
• (pro) Allow specifying gradient direction as an angle in degrees.
• (pro) Speed up ML features.
• (pro) Update the face detection model.

Fix

• Fix HEIC/AVIF dimension limit handling.
• Fix SVG detection when the root element has a namespace.
• Fix treating percent-encoded symbols in s3://, gcs://, abs://, and swift:// URLs.
• (pro) Fix style injection to SVG.
• (pro) Fix video tiles generation when the video's SAR is not 1.

Deprecated

• IMGPROXY_WRITE_TIMEOUT config is deprecated. Use IMGPROXY_TIMEOUT instead.
• IMGPROXY_READ_TIMEOUT config is deprecated. Use IMGPROXY_READ_REQUEST_TIMEOUT instead.

v3.24.1

Fix

• Fix the default IMGPROXY_WORKERS value when cgroup limits are applied.

v3.24.0

Add

• Add IMGPROXY_ALWAYS_RASTERIZE_SVG config.
• Add IMGPROXY_PNG_UNLIMITED and IMGPROXY_SVG_UNLIMITED configs.
• (pro) Add fill, foxus_x, and focus_y arguments to the video_thumbnail_tile processing option.
• (pro) Add the ch (chessboard order) position for watermarks.
• (pro) Add the watermark_rotate processing option.

Change

• Respond with 404 when the bucket/container name or object key is empty in an S3, Google Cloud Storage, Azure Blob Storage, or OpenStack Object Storage (Swift) URL.
• Ensure that the watermark is always centered when replicated.
• (pro) Improve unsharp masking.
• (docker) Update AWS Lambda adapter to 0.8.3.
• (docker) Increase EXIF size limit to 8MB.

Fix

• Fix parsing some TIFFs.
• Fix over-shrinking during scale-on-load.
• Fix watermarks overlapping animation frames in some cases.
• (pro) Fix false-positive video detections.

v3.23.0

Add

• Add request ID, processing/info options, and source image URL to error reports.

Change

• Support configuring OpenTelemetry with standard general and OTLP Exporter environment variables.
• IMGPROXY_MAX_SRC_RESOLUTION default value is increased to 50.

Fix

• Fix loading environment variables from the AWS System Manager Parameter Store when there are more than 10 parameters.
• (pro) Fixed thumbnail generation for MKV/WebM files containing blocks invalidly marked as keyframes.

Deprecated

• IMGPROXY_OPEN_TELEMETRY_ENDPOINT, IMGPROXY_OPEN_TELEMETRY_PROTOCOL, IMGPROXY_OPEN_TELEMETRY_GRPC_INSECURE, IMGPROXY_OPEN_TELEMETRY_SERVICE_NAME, IMGPROXY_OPEN_TELEMETRY_PROPAGATORS, and IMGPROXY_OPEN_TELEMETRY_CONNECTION_TIMEOUT config options are deprecated. Use standard OpenTelemetry environment variables instead.

v3.22.0

Add

• Add the IMGPROXY_TRUSTED_SIGNATURES config.
• (pro) Add the hashsum processing and info options.
• (pro) Add the calc_hashsums info option.
• (pro) Add the IMGPROXY_VIDEO_THUMBNAIL_TILE_AUTO_KEYFRAMES config.
• (pro) Add the IMGPROXY_WEBP_SMART_SUBSAMPLE config and the smart_subsample argument to the webp_options processing option
• (docker) Add lambda adapter to the Docker image.

Change

• Allow relative values for gravity and watermark offsets.
• Revised downloading errors reporting.
• Allow IMGPROXY_TTL to be zero.
• Don't set Expires HTTP header as it is ignored if the Cache-Control header is set.
• Don't log health-check requests and responses.
• Enforce IMGPROXY_WORKERS=1 when running in AWS Lambda.
• Reduce memory usage when scaling down animated images.
• (pro) If the step argument of the video_thumbnail_tile is negative, calculate step automatically.

Fix

• Fix loading animated images with a huge number of frames.
• Fix recursive presets detection.
• (pro) Fix video_thumbnail_tile option behavior when the video has a single keyframe.
• (pro) Fix the trim argument of the video_thumbnail_tile processing option.
• (pro) Fix video_thumbnail_tile behavior when the step argument value is less than frame duration.
• (pro) Fix VPx video stream duration detection.
• (pro) Fix thumbnal generation for VP9 videos.
• (pro) Fix thumbnal generation for videos with a large time base denumenator.

v3.21.0

Add

• Add status_codes_total counter to Prometheus metrics.
• Add client-side decryption support for S3 integration.
• Add HEIC saving support.
• (pro) Add the IMGPROXY_VIDEO_THUMBNAIL_KEYFRAMES config and the video_thumbnail_keyframes processing option.
• (pro) Add the video_thumbnail_tile processing option.
• (pro) Add the duration field to the video streams information in the /info endpoint response.
• (pro) Add the colorspace, bands, sample_format, pages_number, and alpha info options.

Fix

• (pro) Fix detection of some videos.
• (pro) Fix headers and cookies passthrough when the source is a video.
• (pro) Fix wrong behavior of the background_alpha option when the best format is used.
• (docker) Fix saving EXIF strings containing invalid UTF-8 characters.
• (docker) Fix possible segfaults while processing HEIC/AVIF images.
• (docker) Fix rendering GIFs embedded in SVGs.

v3.20.0

Add

• (pro) Add info options support to the /info endpoint.
• (pro) Add video streams info to the /info endpoint response.
• (docker) Add support for TIFFs with 16-bit float samples.
• (docker) Add support for TIFFs with the old-style JPEG compression.

Change

• Limit vector image sizes to IMGPROXY_MAX_SRC_RESOLUTION.
• (pro) Respect image orientation when extracting image dimensions for the /info endpoint response.
• (pro) Respect IMGPROXY_WORKERS and IMGPROXY_REQUESTS_QUEUE_SIZE configs in the /info endpoint.
• (pro) Collect detailed metrics for the /info endpoint.
• (docker) Invalid UTF-8 strings in image metadata are fixed instead of being ignored.

Fix

• Fix parsing of HEIF files with large boxes.
• Fix wrong colors when the source image has a linear colorspace.
• Fix wrong colors or opacity when the source image is a TIFF with a float sample format.
• Fix crashes during processing of large animated WebPs.
• Fix vips_allocs OTel metric unit (was By, fixed to 1).
• (pro) Fix generating thumbnails for WebM videos with transparency.
• (pro) Fix style injection into some SVGs.

v3.19.0

Add

• Add IMGPROXY_WORKERS alias for the IMGPROXY_CONCURRENCY config.
• Add multi-region mode to S3 integration.
• Add the ability to load environment variables from a file or a cloud secret.
• (pro) Add pages processing option.

Change

• Don't report The image request is cancelled errors.
• Create and destroy a tiny image during health check to check that vips is operational.
• (pro) Change the /info endpoint behavior to return only the first EXIF/XMP/IPTC block data of JPEG if the image contains multiple metadata blocks of the same type.

Fix

• Fix reporting image loading errors.
• Fix the Cache-Control and Expires headers behavior when both IMGPROXY_CACHE_CONTROL_PASSTHROUGH and IMGPROXY_FALLBACK_IMAGE_TTL configs are set.
• (pro) Fix the IMGPROXY_FALLBACK_IMAGE_TTL config behavior when the fallback_image_url processing option is used.