Nodes/comfyui-AGSoft/🎬AGSoft Video Save
ComfyUI Node

🎬AGSoft Video Save

Convert, mux audio, or just preview

By Art-xmaster·Created about a year ago·Updated a day ago· 24
🎬AGSoft Video Save
  • images
  • video
  • audio
  • video_path
◄filename_prefixAGSoft_Video►
◄subfolder►
◄video_path►
◄frame_rate24.0►
◄formatvideo/h264-mp4►
◄presetveryfast►
◄crf19►
◄save_videotrue►
◄save_video_with_audiofalse►
◄save_audiofalse►
◄save_imagefalse►
◄save_metadatatrue►
◄save_outputtrue►

🎬AGSoft Video Save is the pack's flexible output node - the one you point at the end of a MiniMax, LTX, or frame-sequence workflow when you want a real file in the format you actually need. It takes a VIDEO object, a video path, or even a raw IMAGE sequence, and converts/saves with a long list of toggles: video with or without audio, audio-only as a separate M4A, a first-frame PNG, and embedded workflow metadata.

The headline feature is that it converts directly through FFmpeg - no intermediate PNG round-trip, which is how a lot of naive "save video" nodes chew up disk space and time. And it's honest about being a saver: it's marked as an output node, so it won't silently do nothing.

The toggles that matter

  • save_video (default on) - saves the video without audio. Confusingly named, but it's the base "write the file" switch.
  • save_video_with_audio - saves with audio. Audio priority: the audio input if connected, otherwise the source video's own audio track.
  • save_audio - saves the audio as a separate M4A file, alongside everything else.
  • save_image - saves the first frame as a PNG. With save_metadata on, that PNG carries the workflow in a tEXt chunk, so dragging it back onto the canvas rebuilds your graph - the "workflow included" culture in file form.
  • save_metadata (default on) - embeds the pure workflow graph into the saved file.
  • save_output (default on) - true saves to your output folder; false saves to temp as a preview only. This is the killer feature for iterating: you can watch a preview without cluttering your output folder.

Inputs and format

Three ways in: video (VIDEO, highest priority), video_path (a file to convert), or images (an IMAGE sequence, used when no video is connected). The format dropdown is built from the encoders actually available in your FFmpeg build (h264-mp4 by default, plus GIF, WebP, FFV1, ProRes and friends), and crf (default 19, 0 = lossless, 51 = worst) controls quality for the formats that use it. frame_rate (default 24) matters when saving from an IMAGE sequence, and filename_prefix + subfolder (nested paths allowed, sanitized) manage where things land.

Output

Just one: video_path (STRING) - where the primary video was saved. If all save options are off, the node is a no-op with a preview (so you can hear the audio before committing).

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 model downloads; it drives the bundled FFmpeg (or a system ffmpeg on PATH).

Where people get confused: save_video defaulting to on but saving without audio. If your output comes out silent, it's not a bug - flip save_video_with_audio on (and check an audio source is actually connected or present in the source video). And if you're just iterating on a look, flip save_output off and let it preview to temp; that's the workflow this node was built for.

CategoryAGSoft/Video

Inputs (16)

NameTypeDefaultDescription
filename_prefixSTRINGAGSoft_VideoPrefix for the output filename. A timestamp is added automatically. --- Префикс имени файла. Временная метка добавляется автоматически.
subfolderSTRINGSubfolder inside the output (or temp) directory. Nested paths are allowed: 'MiniMax' or 'MiniMax/2026'. '..' and unsafe segments are sanitized. Example: MiniMax -> output/MiniMax/AGSoft_Video_<timestamp>.mp4 --- Подпапка внутри папки output (или temp). Разрешена вложенность: 'MiniMax' или 'MiniMax/2026'. '..' и небезопасные сегменты санациируются. Пример: MiniMax -> output/MiniMax/AGSoft_Video_<timestamp>.mp4
video_pathSTRINGOptional: absolute path to a video file to convert. --- Опционально: абсолютный путь к видеофайлу для конвертации.
frame_rateFLOAT24.01–120Frames per second for the output video. --- Кадров в секунду для выходного видео.
formatCOMBOvideo/h264-mp4Output format / codec. The list shows only encoders available in your ffmpeg build. video/copy-mp4 copies the video stream without re-encoding when possible. --- Формат / кодек выхода. В списке показываются только энкодеры, доступные в вашей сборке ffmpeg. video/copy-mp4 копирует видеопоток без перекодирования, если это возможно.
presetCOMBOveryfastEncoding speed / quality preset for CPU encoders. Faster presets encode quicker but may produce larger files. --- Пресет скорости / качества для CPU-энкодеров. Быстрые пресеты кодируют быстрее, но файл может получиться больше.
crfINT190–51Constant Rate Factor: 0 = lossless, 51 = worst. Ignored for GIF/WebP/FFV1/ProRes/copy modes. --- Constant Rate Factor: 0 = без потерь, 51 = худшее качество. Игнорируется для GIF/WebP/FFV1/ProRes/copy-режимов.
save_videoBOOLEANtrueSave video WITHOUT audio. All save options off = no-op with preview (nothing saved, no error). --- Сохранить видео БЕЗ звука. Все опции выключены = no-op с превью (ничего не сохраняется, без ошибки).
save_video_with_audioBOOLEANfalseSave video WITH audio. Audio is taken from the audio input if connected, otherwise from the source video's own audio track. --- Сохранить видео СО звуком. Звук берётся со входа audio, если он подключён, иначе — из звуковой дорожки самого исходного видео.
save_audioBOOLEANfalseSave the audio track as a SEPARATE M4A file. --- Сохранить звуковую дорожку ОТДЕЛЬНЫМ файлом M4A.
save_imageBOOLEANfalseSave the first frame as a PNG image. With save_metadata enabled the PNG also carries the workflow (tEXt chunk after IHDR) and opens it on drag & drop. --- Сохранить первый кадр как PNG. При включённом save_metadata в PNG вшивается воркфлоу (tEXt-чанк после IHDR), и он открывается перетаскиванием.
save_metadataBOOLEANtrueEmbed the workflow (PURE graph, no wrapper) into the saved file's metadata. Dragging the saved PNG onto the canvas opens it natively; dragging the saved video opens it via this extension. --- Вшить воркфлоу (ЧИСТЫЙ граф, без обёртки) в метаданные сохранённого файла. Перетаскивание сохранённого PNG на канвас открывает его штатно; сохранённого видео — через это расширение.
save_outputBOOLEANtrueTrue = save to the output folder; False = save to temp (preview only, no clutter in output). --- True = сохранять в папку output; False = во временную папку (только превью, без мусора в output).
imagesoptIMAGEFrame sequence to save as video. Used when no video / video_path inputs are connected. --- Последовательность кадров для сохранения. Используется, когда не подключены входы video / video_path.
videooptVIDEOOptional: VIDEO object to convert (highest priority). Its own audio track is used when the audio input is not connected. --- Опционально: объект VIDEO для конвертации (наивысший приоритет). Его собственная звуковая дорожка используется, когда вход audio не подключён.
audiooptAUDIOOptional: AUDIO to mux into the video / save as M4A. Highest priority over the source video's own audio track. Also muxed into the no-op preview so you HEAR the result before saving. --- Опционально: AUDIO для подмешивания в видео / сохранения в M4A. Наивысший приоритет перед собственной дорожкой исходного видео. Также подмешивается в no-op превью — результат СЛЫШНО до сохранения.

Outputs (1)

NameTypeDescription
video_pathSTRING—