nodes/foge1024-ComfyUI-AVIF-Animation

Fork 0

Files

T

foge af49840bd3 init

2026-01-15 18:23:17 +08:00

3.9 KiB

Raw Permalink Blame History

ComfyUI-AVIF-Animation - 项目完成总结

📦 项目文件清单

核心文件 (2个)

✅ __init__.py - 节点注册和初始化 ✅ nodes.py - 主节点实现（AVIFAnimationNode类）

文档文件 (6个)

✅ README.md - 完整英文文档 ✅ README_CN.md - 中文快速开始指南 ✅ INSTALL.md - 详细安装指南 ✅ CHANGELOG.md - 版本历史 ✅ PROJECT_STRUCTURE.md - 项目结构说明 ✅ PUBLISH.md - 发布到GitHub的指南

配置文件 (4个)

✅ requirements.txt - Python依赖（无额外依赖） ✅ .gitignore - Git忽略规则 ✅ LICENSE - MIT许可证 ✅ example_workflow.json - 示例工作流

🚀 快速开始

1. 安装avifenc

Windows:

winget install jark006.jarkViewer

macOS:

brew install libavif

Linux:

sudo apt-get install libavif-bin

2. 安装节点

将整个 ComfyUI-AVIF-Animation/ 文件夹复制到：

ComfyUI/custom_nodes/

3. 重启ComfyUI

重启后，在节点菜单中找到 "AVIF Animation (avifenc)" 节点

📋 节点参数

输入

images (IMAGE) - 输入图像序列
fps (INT) - 帧率 (1-120, 默认: 24)
quality (INT) - 颜色质量 (0-100, 默认: 60)
alpha_quality (INT) - 透明质量 (0-100, 默认: 60)
speed (INT) - 编码速度 (0-10, 默认: 6)

输出

avif_path (STRING) - 生成的AVIF文件路径

🎯 核心特性

✅ 透明通道支持 - 完整的alpha通道支持 ✅ 高质量编码 - 使用libavif的avifenc ✅ 苹果兼容 - iOS 16+ 和 macOS Ventura+ 支持 ✅ 高效压缩 - 文件大小合理 ✅ 自动循环 - 无限循环播放 ✅ 灵活参数 - 可调节FPS、质量、速度 ✅ 内存优化 - 自动清理内存 ✅ 多线程处理 - 并行处理图像 ✅ 详细日志 - 完整的控制台输出

📊 格式对比

格式	透明	文件大小	苹果兼容	推荐度
AVIF (avifenc)	✅	中等	✅	⭐⭐⭐⭐⭐
WebP	✅	最小	✅	⭐⭐⭐⭐
WebM (VP9)	✅	小	❌	⭐⭐
MOV (ProRes)	✅	大	✅	⭐⭐
GIF	❌	中等	✅	⭐

📝 使用示例

基础用法

Load Images → AVIF Animation (avifenc) → Save/Preview

高质量动画

FPS: 30
Quality: 80
Alpha Quality: 80
Speed: 4

快速编码

FPS: 24
Quality: 50
Alpha Quality: 50
Speed: 8

小文件大小

FPS: 15
Quality: 40
Alpha Quality: 40
Speed: 6

🔧 技术细节

编码流程

输入tensor序列 → PNG帧（临时文件）
PNG帧 → avifenc → AVIF动画
AVIF文件 → ComfyUI输出目录

支持的功能

AVIF 1.0 规范
YUV444 颜色格式
Alpha通道（非预乘）
无限循环播放
可变帧率

🌐 发布到GitHub

步骤

创建GitHub仓库：ComfyUI-AVIF-Animation
上传所有文件
创建Release：v1.0.0
更新README
提交到ComfyUI Registry

详细步骤见 PUBLISH.md

📄 许可证

MIT License - 可自由使用、修改和分发

💡 下一步

可选改进

GPU加速支持（如果未来avifenc版本支持）
批量处理多个动画
自定义输出目录选项
ComfyUI内预览功能
更多AVIF编码参数

🆘 故障排除

avifenc未安装

解决： 按照INSTALL.md安装avifenc

节点未出现在菜单

解决： 检查文件结构，重启ComfyUI

文件太大

解决： 降低quality和alpha_quality参数

编码太慢

解决： 增加speed参数（尝试8-10）

📞 支持

GitHub Issues: https://github.com/YOUR_USERNAME/ComfyUI-AVIF-Animation/issues
ComfyUI Discord: https://discord.gg/comfyui

✅ 完成状态

所有文件已创建完成，项目可以直接发布！

3.9 KiB Raw Permalink Blame History Unescape Escape