ComfyUI_UniversalMediaLoader 是一套简化 ComfyUI 工作流的强大自定义节点套件。它打破了传统工作流中需要针对不同媒体类型（图像、视频、音频）切换不同加载节点的繁琐流程，提供了一个统一的交互式界面。用户只需拖放文件，即可在单个节点内完成媒体的加载、裁剪、遮罩绘制、时间线修剪及元数据提取，极大提升了创作效率。
- GitHub：https://github.com/Fictiverse/ComfyUI_UniversalMediaLoader
核心亮点
- 全能媒体支持：无缝处理图像（PNG, JPG, WEBP等）、视频/动图（MP4, GIF, MOV等）及音频（WAV, MP3, FLAC等）。
- 交互式可视化 UI：
- 智能画布生成器：未加载文件时，可作为分辨率规划器，支持主流宽高比预设、方向切换及 32px 网格对齐（适配 SD1.5/SDXL/Flux）。
- 可视化裁剪与外画：提供交互式裁剪框，支持宽高比锁定及“外画模式”（Outpainting），缺失区域自动填充并生成遮罩。
- 内置遮罩编辑器：直接在节点上绘制或擦除遮罩，支持画笔大小调节，适用于 Inpainting 工作流。
- 专业级时间线控制：
- 针对视频和 GIF 提供完整的时间线轨道、波形预览及修剪手柄。
- 支持自定义输出 FPS、音频静音、循环播放及精确到帧的修剪。
- 音频处理增强：支持高清晰度波形显示、1秒磁吸吸附修剪及实时变速（0.1x – 4.0x，保留音高）。
- 高效数据解包：通过
MEDIA_DATA统一输出格式，配合专用的 Unpack 节点，可轻松提取尺寸、张量、音频波形及元数据，避免不必要的解码开销。
节点详解
| 节点名称 | 功能描述 | 关键输出 |
|---|---|---|
| Universal Media Loader | 主交互节点，负责拖放加载、画布配置及可视化编辑。 | media_data (MEDIA_DATA) |
| Universal Size Unpack | 轻量级提取尺寸信息，无需解码像素，适合动态调整潜空间大小。 | width, height, aspect_ratio, megapixels |
| Universal Image Unpack | 从各类视觉媒体中提取图像张量及遮罩。视频模式下自动提取首、中、尾三帧。 | image, mask, rgba_image, crop_coords |
| Universal Audio Unpack | 提取音频波形、采样率及修剪后的时长信息。 | audio, sample_rate, duration, trim_start/end |
| Universal Video Unpack | 将视频/GIF 解码为帧批次，同步提取音频与遮罩。 | frames, mask, audio, fps, frame_count |
适用场景
- 快速原型设计：通过画布生成器快速规划不同模型的输入分辨率。
- 视频重绘与编辑：利用内置的时间线修剪和遮罩工具，直接准备 Video-to-Video 或 Inpainting 素材。
- 多模态创作：在同一工作流中轻松整合图像、视频和音频元素，无需复杂的预处理脚本。
- 精准控制：通过可视化的裁剪和外画工具，实现对构图和画面边界的精确把控。
安装指南
- 进入 ComfyUI 的自定义节点目录：
cd ComfyUI/custom_nodes/ - 克隆仓库：
git clone https://github.com/Fictiverse/ComfyUI_UniversalMediaLoader.git - 重启 ComfyUI 服务器。
© 版权声明
文章版权归作者所有，未经允许请勿转载。
