VMTech Edit Image

VMTech Edit Image is an n8n community node for raster image processing with a modern sharp pipeline and reliable text rendering based on fontkit.

Package name: n8n-nodes-vmtech-edit-image
Node name in n8n: VMTech Edit Image

Русский

Что это

VMTech Edit Image это community node для n8n, которая работает рядом со встроенной Edit Image и не изменяет core n8n.

Нода предназначена для multi-step обработки изображений с binary input и binary output.

Поддерживаемые операции:

• information
• multiStep
• blur
• border
• composite
• create
• crop
• draw
• rotate
• resize
• shear
• text
• transparent
• flip
• flop
• pad
• sharpen
• opacity
• format

Что важно в этой ноде

По сравнению со встроенной Edit Image эта нода делает акцент на стабильности и качестве рендера:

• последовательный multiStep pipeline по умолчанию
• обработка без ImageMagick, GraphicsMagick и shell-команд
• modern image engine на sharp
• отдельная подсистема текста на базе fontkit
• более надёжный рендер текста через SVG overlay + compositing
• работа рядом со встроенной Edit Image, без замены core-функционала n8n

Что улучшено в работе с текстом

Операция text была сделана как более надёжная замена типичному "нарисовать строку на картинке":

• корректнее работает с длинными строками и длинными абзацами
• поддерживает переносы, многострочный текст и многоабзацный текст
• лучше ведёт себя с кириллицей и латиницей
• поддерживает font family, font size, font weight, font style
• поддерживает line-height, color, background color
• поддерживает horizontal align и vertical align
• поддерживает overflow modes: wrap, shrink-to-fit, clip, ellipsis

Если вам важно надёжно размещать текст на изображении внутри workflow, это одно из ключевых отличий данной ноды.

Новый функционал сверх built-in Edit Image

Помимо parity со стандартными операциями, в ноду добавлены расширения:

• flip
• flop
• pad
• sharpen
• opacity
• явное преобразование format
• отдельный Output Binary Property Name в Options
• helper-переключатель для визуального показа области текста

Это позволяет использовать ноду как более современную замену built-in Edit Image в сценариях, где нужно несколько последовательных преобразований в одном узле.

Новые удобства в UI

• Input Property Name задаёт, из какого binary property брать исходное изображение
• Options > Output Binary Property Name позволяет записать результат не в data, а в любой другой binary key, например editedImage
• в операции text появился переключатель Show Text Box Helper, который рисует тонкую красную пунктирную рамку поверх изображения и визуально показывает область текста

Установка через интерфейс n8n

Это рекомендуемый способ для пользователей self-hosted n8n.

1. Откройте Settings > Community Nodes
2. Нажмите Install
3. Укажите пакет n8n-nodes-vmtech-edit-image
4. Подтвердите установку community node
5. После установки найдите ноду VMTech Edit Image в списке нод

Что нужно для Docker n8n

Для большинства операций достаточно:

• self-hosted n8n
• включённые community nodes
• persistent volume для ~/.n8n

Пример:

services:
  n8n:
    image: n8nio/n8n:latest
    volumes:
      - ./n8n_data:/home/node/.n8n

Без этого установленный пакет может исчезнуть после пересоздания контейнера.

Шрифты для операции text

Если вы используете операцию text, рекомендуется примонтировать каталог со шрифтами в контейнер:

services:
  n8n:
    image: n8nio/n8n:latest
    volumes:
      - ./n8n_data:/home/node/.n8n
      - ./fonts:/usr/share/fonts/truetype/custom:ro

Нода ищет шрифты в:

• /usr/share/fonts/truetype/custom
• /srv/fonts

Для Docker runtime основной путь это /usr/share/fonts/truetype/custom.

Важно:

• в смонтированной папке должны быть реальные .ttf или .otf файлы
• для качественной работы text лучше явно монтировать пользовательские шрифты
• если шрифтов нет, операция text может работать не так, как ожидается, или не иметь нужного семейства шрифтов

Ручная установка в Docker

Если вы не хотите ставить пакет через UI, можно установить его вручную внутри контейнера:

docker exec -it <n8n-container> sh
mkdir -p ~/.n8n/nodes
cd ~/.n8n/nodes
npm install n8n-nodes-vmtech-edit-image
exit
docker restart <n8n-container>

Лучше устанавливать пакет именно внутри контейнера, чтобы зависимости вроде sharp собирались и ставились под корректный runtime.

Когда использовать эту ноду

VMTech Edit Image особенно полезна, если вам нужно:

• выполнить несколько операций над изображением в одной ноде
• надёжно накладывать текст на изображение
• использовать кастомные шрифты в Docker
• управлять прозрачностью и форматом выходного файла
• заменить хрупкие старые image pipelines на sharp

Возможные проблемы

Если нода не загружается:

• проверьте, что community nodes не отключены
• проверьте, что ~/.n8n сохраняется через volume
• при необходимости используйте N8N_REINSTALL_MISSING_PACKAGES=true как fallback

Если не работает text:

• проверьте mount шрифтов
• проверьте наличие .ttf или .otf внутри контейнера
• проверьте, что нужное семейство шрифтов реально существует в смонтированном каталоге

English

What It Is

VMTech Edit Image is an n8n community node that works alongside the built-in Edit Image node without modifying n8n core.

It is designed for multi-step image processing with binary input and binary output.

Supported operations:

• information
• multiStep
• blur
• border
• composite
• create
• crop
• draw
• rotate
• resize
• shear
• text
• transparent
• flip
• flop
• pad
• sharpen
• opacity
• format

Why This Node Is Different

Compared to the built-in Edit Image, this node prioritizes stability and rendering quality:

• sequential multiStep pipeline by default
• no ImageMagick, GraphicsMagick, or shell-based image tooling
• modern image engine based on sharp
• dedicated text subsystem powered by fontkit
• more reliable text rendering through SVG overlays and compositing
• works next to the built-in Edit Image node instead of replacing core n8n behavior

Better Text Rendering

The text operation was built as a more reliable alternative to the usual "draw a string on an image" approach:

• handles long strings and long text blocks more predictably
• supports wrapping, multiline text, and multiple paragraphs
• behaves better with both Cyrillic and Latin text
• supports font family, font size, font weight, and font style
• supports line-height, color, and background color
• supports horizontal and vertical alignment
• supports overflow modes: wrap, shrink-to-fit, clip, and ellipsis

If accurate text placement inside image workflows matters to you, this is one of the main reasons to use this node.

Added Functionality Beyond Built-In Edit Image

In addition to parity with the core feature set, this node adds:

• flip
• flop
• pad
• sharpen
• opacity
• explicit format conversion
• a separate Output Binary Property Name option
• a text area helper toggle for visual placement

This makes it a more modern replacement for the built-in Edit Image node when you need multiple sequential transformations inside one node.

New UI Conveniences

• Input Property Name defines which binary property contains the source image
• Options > Output Binary Property Name lets you write the processed image to any binary key instead of always using data, for example editedImage
• the text operation now includes a Show Text Box Helper toggle that draws a thin red dashed rectangle over the image to visualize the text area

Install Through the n8n UI

This is the recommended installation path for self-hosted n8n users.

1. Open Settings > Community Nodes
2. Click Install
3. Enter n8n-nodes-vmtech-edit-image
4. Confirm the community node installation
5. After installation, search for VMTech Edit Image in the nodes panel

Docker Requirements

For most operations, users only need:

• self-hosted n8n
• community nodes enabled
• a persistent volume for ~/.n8n

Example:

services:
  n8n:
    image: n8nio/n8n:latest
    volumes:
      - ./n8n_data:/home/node/.n8n

Without this, the installed package may disappear when the container is recreated.

Fonts for the Text Operation

If you use the text operation, mounting a font directory into the container is strongly recommended:

services:
  n8n:
    image: n8nio/n8n:latest
    volumes:
      - ./n8n_data:/home/node/.n8n
      - ./fonts:/usr/share/fonts/truetype/custom:ro

The node looks for fonts in:

• /usr/share/fonts/truetype/custom
• /srv/fonts

For Docker runtime, the main path is /usr/share/fonts/truetype/custom.

Important:

• the mounted directory should contain real .ttf or .otf files
• for reliable text rendering, explicitly mounting custom fonts is recommended
• if no suitable fonts are available, the text operation may not behave as expected or may not find the required font family

Manual Docker Installation

If you don't want to install the package through the UI, you can install it manually inside the container:

docker exec -it <n8n-container> sh
mkdir -p ~/.n8n/nodes
cd ~/.n8n/nodes
npm install n8n-nodes-vmtech-edit-image
exit
docker restart <n8n-container>

It is better to install the package inside the container so dependencies such as sharp are installed for the correct runtime.

When to Use This Node

VMTech Edit Image is especially useful when you need to:

• apply multiple image operations inside one node
• place text on images more reliably
• use custom fonts in Docker
• control transparency and output format explicitly
• replace fragile legacy image pipelines with sharp

Common Problems

If the node doesn't load:

• make sure community nodes are enabled
• make sure ~/.n8n is persisted with a volume
• if needed, use N8N_REINSTALL_MISSING_PACKAGES=true as a fallback

If text doesn't work correctly:

• check the font mount
• check that .ttf or .otf files are actually available inside the container
• check that the requested font family really exists in the mounted directory