image-editor-pro

Package Information

Released: 7/5/2025
Downloads: 0 weekly / 0 monthly
Latest Version: 1.1.8
Author: ofekbh

Available Nodes

ImageEditorPro
Advanced image editing: collage, text overlay, watermark

Documentation

📸 ImageEditorPro – Custom Node for n8n

Advanced image manipulation node for n8n.io using sharp and @napi-rs/canvas.

✨ Features

🧩 Collage Mode

Combine multiple images into a grid layout with:

  • Custom number of rows and columns (e.g. 2x2, 3x3)
  • Spacing between images
  • Background color

✍️ Add Text Mode

Overlay styled text onto an image with full control:

  • Text content
  • Font size
  • Font color
  • Opacity
  • Position:
    • top-left
    • center
    • bottom-right
    • custom (X/Y coordinates)
  • Background shape behind the text:
    • none (default)
    • rectangle
    • circle
  • Background shape styling:
    • backgroundColor: Fill color (e.g. #00000088)
    • padding: Space around the text inside the shape
    • borderColor: Outline color
    • borderWidth: Outline thickness

💦 Add Watermark Mode

Add a watermark text to an image:

  • Watermark content
  • Positioning (same options as Add Text)
  • Opacity

🌐 Input Options

Supports both:

  • Binary image input from previous n8n nodes (e.g. HTTP Request → Binary)
  • URLs (comma-separated string)

📤 Output

Returns the processed image as a binary PNG with key: data.

🧪 Example Use-Cases

  • Add price or name labels to product images
  • Generate automatic preview collages
  • Brand content with watermarks
  • Highlight information with background text badges

🚀 Installation

Option 1: Install via n8n Community Nodes (Recommended)

  1. Go to Settings → Community Nodes in your n8n instance
  2. Click Install a Community Node
  3. Enter the package name:
n8n-nodes-image-editor-pro
  1. Click Install

⚠️ Requirements (Linux / Alpine-based systems)

If installation fails with errors related to canvas.node or missing libraries, you need to install system dependencies:

For Ubuntu/Debian:

sudo apt update
sudo apt install -y libcairo2-dev libjpeg-dev libpango1.0-dev libgif-dev librsvg2-dev build-essential g++

For Alpine (e.g., in Docker):

apk add --no-cache \
  cairo-dev \
  jpeg-dev \
  pango-dev \
  giflib-dev \
  librsvg-dev \
  build-base \
  gcc \
  g++ \
  python3 \
  nodejs \
  npm

Then rebuild the node container or restart n8n.

🧱 Development & Manual Installation

git clone https://github.com/YOUR_USERNAME/n8n-nodes-image-editor-pro.git
cd n8n-nodes-image-editor-pro
npm install
npm run build

🛠 Troubleshooting

  • Error about canvas.node: make sure all system libraries for node-canvas are installed (see above).
  • Use npm rebuild canvas inside .n8n/nodes/node_modules/n8n-nodes-image-editor-pro if issues persist.
  • You may also need to restart the container if running n8n in Docker.

📦 Publishing

To publish your own version to npm:

npm version patch
npm publish

🧠 Contribute

Pull requests are welcome! Ideas for features:

  • Support SVG inputs
  • Auto-resize text to fit area
  • Add borders/shadows to text or images

Discussion