Download Tools

🚀 ComfyUI下载工具

ComfyUI的自定义节点，可从包括Instagram、Reddit、Twitter、YouTube、TikTok等在内的1000多个网站下载媒体。

🚀 快速开始

Gallery-dl下载器

1. 在你的工作流中添加“Gallery-dl Downloader”节点。
2. 输入一个URL（例如，Instagram个人资料、Reddit帖子）。
3. 配置选项：
   • 对于私有内容，启用use_browser_cookies。
   • 启用organize_files按类型排序。
   • 启用use_download_archive避免重复下载。
4. 执行！

支持的网站：Instagram、Reddit、Twitter、DeviantArt、Pixiv、Tumblr、Pinterest、Flickr等90多个网站。请参阅gallery-dl支持的网站。

Yt-dlp下载器

1. 在你的工作流中添加“Yt-dlp Downloader”节点。
2. 输入一个URL（例如，YouTube视频）。
3. 选择格式：
   • best - 最佳质量视频。
   • audio-only - 提取音频（需要FFmpeg）。
   • 自定义格式字符串。
4. 执行！

支持的网站：YouTube、TikTok、Vimeo、Twitch、Facebook、Instagram、Twitter等1000多个网站。请参阅yt-dlp支持的网站。

✨ 主要特性

• Gallery-dl节点 - 从100多个网站下载图像和视频

  • Instagram、Reddit、Twitter/X、DeviantArt、Pixiv等。
  • 支持通过浏览器cookie进行身份验证。
  • 自动文件组织。
  • 下载存档以避免重复。

• Yt-dlp节点 - 从1000多个平台下载视频和音频

  • YouTube、TikTok、Vimeo、Twitch等。
  • 多种质量选项。
  • 支持音频提取。
  • 支持播放列表。

📦 安装指南

使用ComfyUI管理器（推荐）

1. 打开ComfyUI管理器。
2. 搜索“Download Tools”。
3. 点击安装。

手动安装

1. 将此仓库克隆或下载到你的ComfyUI custom_nodes文件夹：

   cd ComfyUI/custom_nodes
   git clone https://github.com/EricRollei/download-tools.git
   

2. 安装依赖项：

   # Windows（使用ComfyUI的Python）
   .\ComfyUI\python_embeded\python.exe -m pip install -r download-tools\requirements.txt
   
   # 或者使用系统Python
   pip install -r download-tools/requirements.txt
   

3. （可选）安装FFmpeg用于音频提取：

   • Windows：choco install ffmpeg或从https://ffmpeg.org/ 下载。
   • macOS：brew install ffmpeg。
   • Linux：apt-get install ffmpeg。

4. 重启ComfyUI。

🔐 身份验证

许多网站需要身份验证才能访问私有内容：

方法1：浏览器cookie（自动）

1. 在你的浏览器中登录该网站。
2. 在节点中启用use_browser_cookies。
3. 选择你的浏览器（Chrome、Firefox、Edge等）。
4. 节点将自动使用你的登录会话。

方法2：导出cookie

1. 安装浏览器扩展：“Get cookies.txt LOCALLY”。
2. 登录该网站。
3. 导出cookie。
4. 保存到configs/instagram_cookies.json（或特定网站的文件）。
5. 在节点中设置cookie_file参数。

📁 配置

配置文件存储在download-tools/configs/中：

• gallery-dl.conf - Gallery-dl设置。
• gallery-dl-browser-cookies.conf - 浏览器cookie配置。
• yt-dlp.conf - Yt-dlp默认设置。
• yt-dlp-audio.conf - 音频提取预设。
• yt-dlp-hq.conf - 高质量预设。

你可以创建自定义配置文件并在节点中引用它们。

📚 详细文档

Docs/中提供了详细指南：

• gallery_dl_node_complete_guide.md - Gallery-dl完整使用方法。
• yt_dlp_node_complete_guide.md - Yt-dlp完整使用方法。
• gallery_dl_authentication_guide.md - 身份验证设置。
• gallery_dl_advanced_options_guide.md - 高级功能。

🐛 故障排除

“gallery-dl未找到”

已经安装了！它是一个Python包。节点将自动找到它。

“无法访问Chrome cookie”

尝试以下操作：

• 以管理员身份运行ComfyUI。
• 改用Firefox。
• 手动导出cookie（方法2）。

“Instagram/Reddit下载失败”

需要身份验证：

• 启用use_browser_cookies。
• 或者从已登录的浏览器导出cookie。

“CUDA内存不足” / “未找到FFmpeg”

对于音频提取：

• 单独安装FFmpeg。
• 或者使用视频格式。

🔧 技术细节

系统要求

📄 许可证

版权所有 (c) 2025 Eric Hiss。保留所有权利。

双重许可：

• 非商业用途：根据[知识共享署名 - 非商业性使用 4.0 国际许可协议 (CC BY - NC 4.0)](http://creativecommons.org/licenses/by - nc/4.0/) 许可。
• 商业用途：需要单独的商业许可证。联系：eric@historic.camera 或 eric@rollei.us。

完整条款请参阅LICENSE.md。

第三方工具

• gallery-dl（GNU GPL v2）由Mike Fährmann开发：https://github.com/mikf/gallery-dl
• yt-dlp（Unlicense/公共领域）：https://github.com/yt-dlp/yt-dlp

完整依赖列表请参阅CREDITS.md。

👥 贡献

欢迎贡献！指南请参阅CONTRIBUTING.md。

📧 联系

• 作者：Eric Hiss
• GitHub：EricRollei
• 邮箱：eric@historic.camera，eric@rollei.us

🙏 致谢

• ComfyUI社区提供的平台。
• Mike Fährmann开发的gallery-dl。
• yt-dlp贡献者开发的优秀视频下载器。

准备好下载了！ 🚀 将节点添加到你的工作流中，开始从网络上下载媒体。