Image StitcherInstall

Summary

Stitch images vertically from a MinIO source bucket in a specified order, with configurable spacing, alignment, resizing, background color, and output format. Optionally upload the stitched image to a MinIO destination bucket and output it as binary data in the node.

Inputs

• Source Bucket (required) — The MinIO bucket name from which to fetch the source images.
• Source Keys (required) — Keys (file names) of images to stitch, entered one per line or comma-separated; order determines vertical stitch order.
• Spacing (Px) — Vertical spacing in pixels between stitched images.
• Horizontal Alignment — Alignment of images horizontally within the stitched image canvas (left, center, or right).
• Normalize Width — Whether to resize all images to the same width to avoid side gaps.
• Target Width — If Normalize Width is enabled and >0, sets the fixed width to resize images to; otherwise widest image width is used.
• Allow Upscale — Whether smaller images can be enlarged to the target width when normalizing.
• Background Color — Background color of the stitched image canvas, accepts hex with optional alpha or 'transparent'.
• Output Format — Output image format: PNG, JPEG, or WEBP.
• Quality — Quality setting (1-100) for JPEG and WEBP formats.
• Destination Bucket — MinIO bucket where the stitched image will be uploaded; if omitted, no upload occurs.
• Destination Key — Key name under which to upload the stitched image in the destination bucket.
• Also Output Binary — Whether to include the stitched image as binary data in the node's output.
• Binary Property — Property name used to store the stitched image binary data when outputted.

Output shape

a single item containing stitched image metadata and optional binary data

The output JSON includes source bucket, keys, canvas dimensions, and upload info if applicable. If enabled, binary data is included as base64 under the specified property name with mime type and filename. Only one output item is returned. Errors for individual input items are handled per standard n8n node error practices.

Examples

Example 1: Stitch three images vertically with 10px spacing, center aligned, normalize width to 500px, output as JPEG with quality 90, and upload to a MinIO bucket

Set Source Bucket and Source Keys to image keys; set Spacing to 10; Alignment to center; Normalize Width to true; Target Width to 500; Allow Upscale true; Output Format to JPEG; Quality to 90; Destination Bucket and Destination Key as desired; Also Output Binary true to attach the image as binary in the node output.