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貢獻者開發的優秀視頻下載器。

準備好下載了！ 🚀 將節點添加到你的工作流中，開始從網絡上下載媒體。