🔤 AGSoft Text Overlay

Every workflow eventually needs a caption burned onto an image - the settings you used, a watermark, subtitles for a video pass - and stock ComfyUI gives you nothing for it. 🔤 AGSoft Text Overlay from comfyui-AGSoft is the closest thing to a full text-layout engine inside the graph: fourteen bundled fonts, stroke, drop shadow, a rounded background box, rotation, and even mask-based positioning. WAS Node Suite has a text overlay too, but it's a toy next to this one.

How it works

Under the hood it's Pillow (ImageDraw) drawing on a temporary RGBA layer, then compositing over your image. The pack ships its fonts in a fonts/ directory inside the repo - everything from impact.ttf to RubikBeastly-Regular.ttf - so you don't download a thing. If a font file can't be loaded it silently falls back to Pillow's default font, which is worth remembering when your text suddenly looks like a terminal window.

The essentials a beginner actually sets:

• text - multiline, so drop a whole paragraph in. Newlines become line breaks.
• font_name / font_size - pick from the bundled list; size up to 1024.
• font_color - a 30-color dropdown, or pick custom and fill in font_color_hex (same pattern for stroke, shadow, and box colors).
• stroke_width / shadow_x / shadow_y - outline and drop-shadow controls. Default 0 means off.
• box_padding, box_opacity, box_radius - the background box behind the text. Bump opacity and it becomes a caption bar.
• align (vertical: center/top/bottom), justify (horizontal), text_align (inside the text block), margins, line_spacing, position_x / position_y for nudging, and rotation_angle in degrees.

That's a lot of knobs, but they're all zero-or-sane by default: the node centers your text and you nudge from there.

The mask trick

The killer feature is the optional mask input. Instead of hand-positioning, draw a mask with ComfyUI's built-in mask editor on an image node, feed it in, and the node computes the text area from the mask's bounding box - it centers the text inside whatever region you painted. For watermarking the bottom-right corner of a whole batch, you paint once and it just follows the region. Note that a connected mask overrides your margins, position, justify, and align; the mask defines the box.

Why you'd reach for it

• Stamp the settings/prompt onto a render before posting it.
• Add subtitles or title cards to an image sequence headed into a video workflow.
• Batch-watermark an output directory with your handle and model name.

Installing and troubleshooting

Same as the rest of the pack:

cd ComfyUI/custom_nodes
git clone https://github.com/Art-xmaster/comfyui-AGSoft.git
# restart ComfyUI

Or search comfyui-AGSoft in ComfyUI Manager. The overlay node needs Pillow, which ComfyUI already depends on, so no extra install beyond the pack itself.

The gotchas are all visual: if your "custom" color isn't applied, you probably left the dropdown on a preset instead of custom. If text looks wrong, check you're picking from the pack's bundled fonts rather than expecting your system's. And the mask overrides positioning - if you're fighting placement, disconnect the mask and check whether it's the culprit.