🎬AGSoft Video Overlay

🎬AGSoft Video Overlay puts text and/or an image watermark onto a video. It's the node for adding a lower-third-style label, burning in your handle so nobody crops it out, or stamping a logo on every frame. Underneath it's FFmpeg's drawtext and overlay filters with the rough edges sanded off.

There are two independent layers, and you can use either or both:

• Text - overlay_text plus font_name (from the pack's own fonts/ folder - the default (none) means no text, so you must pick a font), font_color from a preset palette of FFmpeg/X11 color names, font_alpha (1.0 = opaque), and font_size.
• Image watermark - watermark_path pointing at a PNG (transparency recommended), watermark_scale as a size multiplier, and watermark_alpha.

The part that bites people: X/Y expressions

text_x, text_y, watermark_x, watermark_y are not pixel numbers - they're FFmpeg position expressions, and this is where most users stumble. The good news is the defaults and examples are the idioms you actually want:

• 20 - 20px from the left/top edge.
• (W-tw)/2 - horizontally centered (W = video width, tw = text width).
• W-tw-20 - right-aligned with a 20px margin.
• H-th-20 - bottom-aligned with a 20px margin (this is the default text_y, i.e. bottom-right text).

If you type a nonsense expression, FFmpeg errors and the node fails - the error message is the usual cryptic ffmpeg stderr, so copy the expression and check it against those examples before assuming the node is broken.

The video source is unusual in this pack: the video input is a STRING path that auto-converts to a socket when you drop a connection onto it. Works either way. encoder_mode (auto prefers NVENC) and quality_preset (fast / balanced / quality) control the re-encode - and this node always re-encodes, since it's compositing frames.

Outputs

The standard set: video_path (STRING), duration_seconds, duration_timecode, file_size_mb, width, height, fps, frames_est. Empty output_path → ComfyUI/output.

Install

Part of the comfyui-AGSoft pack. ComfyUI Manager → search "comfyui-AGSoft" → Install → restart, or:

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

Restart. No models - the fonts/ folder ships with the pack, and everything runs through the bundled FFmpeg (or a system ffmpeg on PATH).

Quick practical notes: for a watermark you actually want people to see, skip overlay_text and load a PNG - text from drawtext is fine for captions but a real logo scales better. And if your text doesn't show up at all, 90% of the time you left font_name at (none).