This node extends and refines the classic ComfyUI Text Overlay concept with a re-engineered rendering engine, precise alignment logic, new customization parameters, and enhanced batch handling — making it the most advanced text overlay solution available for ComfyUI.

✨ Key Improvements & New Features

🧱 1. Rebuilt Rendering Engine

Fully restructured text rendering logic for higher precision and cleaner anti-aliasing.
Pixel-accurate bounding box calculations ensure text aligns perfectly to the intended position.
Consistent stroke behavior across font sizes with improved blending and color stability.

🎨 2. Extended Styling and Layout Control

Line spacing, letter spacing and padding parameters for advanced multi-line composition.
Independent X/Y shifting for fine-tuned manual positioning.
Full hex color control for both text fill and stroke.
Supports transparent overlays for non-destructive compositing.

🧭 3. Smarter Alignment and Positioning

Expanded support for:
- Horizontal alignment: left, center, right
- Vertical alignment: top, middle, bottom
Reliable anchor-based alignment even on varying resolutions and batch images.

🔠 4. Font Management

Custom fonts can be loaded directly from the repo’s /fonts directory.
Supports both .ttf and .otf formats.
Graceful fallback to a system font if a specified font is unavailable.

⚙️ 5. Batch and Workflow Enhancements

Native batch support — automatically applies consistent overlay logic across all input images.
Optimized performance and memory use when processing large image sets.
Node parameters persist and preview correctly in ComfyUI sessions.

🧩 6. Developer & Extensibility Features

Modularized code for easier maintenance and feature additions.
Clean separation between text layout and rendering logic.
Ready for further extensions such as shadow layers, gradient text, or dynamic variable injection.

⚙️ Installation

To install the Advanced Text Overlay node:

Locate your ComfyUI custom_nodes directory. Typically found at:
```
ComfyUI/custom_nodes/
```

Clone this repository into that directory:

git clone https://github.com/scofano/ComfyUI-Advanced-TextOverlay

Restart ComfyUI. The node will appear under the image/text category as “Advanced Text Overlay”.

🚀 Usage

Add the Advanced Text Overlay node to your ComfyUI workflow.
Connect your image source to the node’s image input.
Configure text and style parameters:
- Text content
- Font and size
- Fill and stroke colors
- Alignment, spacing, and offset adjustments
Connect the node’s output to your desired destination (e.g., preview, save image).

🔧 Input Parameters

Parameter	Type	Description
image	Image / Batch	Input image(s) to overlay text onto.
text	String	The text content to render on the image. Supports multi-line text.
font	String	Font name or filename (e.g., `arial.ttf`). Looks in `/fonts` or system fonts.
font_size	Integer	Size of the text in pixels.
fill_color_hex	String	Text fill color in hex format (e.g., `#FFFFFF`).
stroke_color_hex	String	Stroke (outline) color in hex format (e.g., `#000000`).
stroke_thickness	Float	Thickness of the text outline.
padding	Float	Additional space around the text block. Useful for multi-line layouts.
horizontal_alignment	Enum	`left`, `center`, or `right` horizontal alignment.
vertical_alignment	Enum	`top`, `middle`, or `bottom` vertical alignment.
x_shift	Float	Horizontal offset adjustment (pixels).
y_shift	Float	Vertical offset adjustment (pixels).
line_spacing	Float	Vertical spacing between lines of text.
letter_spacing	Float	Horizontal spacing between letters.

🖼️ Output

The node outputs the modified image (or batch of images) with the specified text overlay applied according to the given configuration.

🧠 Credits

Original concept by mikkel
Fork base by munkyfoot
Advanced reimplementation and feature expansion by scofano

README.md Unescape Escape

🖋️ ComfyUI Advanced Text Overlay