Download Tools for ComfyUI

Download Tools for ComfyUI

ComfyUI custom nodes for downloading media from 1000+ websites including Instagram, Reddit, Twitter, YouTube, TikTok, and more.

🎉 Features

• Gallery-dl Node - Download images and videos from 100+ websites

  • Instagram, Reddit, Twitter/X, DeviantArt, Pixiv, and more
  • Resolution filtering - Skip small images (default: 768px minimum)
  • Supports authentication via config file or browser cookies
  • Automatic file organization
  • Download archive to avoid duplicates
  • Persistent config paths - Paths are remembered between sessions
  • Configurable timeout - Up to 1 hour for large downloads

• Web Image Scraper Node - Extract images from any website via Playwright

  • 25+ site-specific handlers for optimised extraction
  • Automatic full-resolution image detection (skips thumbnails)
  • Multi-page pagination and infinite-scroll support
  • Spoiler / hidden-content auto-reveal (IPS forums)
  • Video link collection (YouTube / Vimeo) for use with yt-dlp
  • Duplicate detection via perceptual hashing
  • Configurable minimum dimensions, parallel downloads

• Yt-dlp Node - Download videos and audio from 1800+ platforms

  • YouTube, TikTok, Vimeo, Twitch, and more
  • Multiple quality options
  • Audio extraction support
  • Playlist support
  • Authentication via cookies or credentials

📺 Yt-dlp Supported Sites (Major Platforms)

The yt-dlp node supports 1800+ websites. Here are the most popular ones:

Video Platforms

| Platform | Features | Auth Required | |----------|----------|---------------| | YouTube | Videos, playlists, channels, shorts, live streams, music | Optional (for age-restricted/private) | | Vimeo | Videos, albums, channels, on-demand, showcases | Optional (for private content) | | Twitch | VODs, clips, live streams | Optional | | TikTok | Videos, user profiles, collections | No | | Dailymotion | Videos, playlists, user content | Optional | | Facebook | Videos, reels, ads | No | | Instagram | Videos, reels, stories | No (use gallery-dl for images) | | Twitter/X | Videos, spaces, broadcasts | No | | Reddit | Video posts | No | | Rumble | Videos, channels | No | | Kick | VODs, clips, live streams | No | | Odysee/LBRY | Videos, channels, playlists | No |

Streaming Services (May Require Subscription)

| Platform | Notes | |----------|-------| | Crunchyroll | Anime streaming | | Nebula | Creator platform | | CuriosityStream | Documentaries | | Dropout | Comedy streaming | | Patreon | Creator videos | | Floatplane | Tech creator content |

Music & Audio

| Platform | Features | |----------|----------| | SoundCloud | Tracks, playlists, user content | | Bandcamp | Albums, tracks | | Mixcloud | Mixes, playlists | | Audiomack | Tracks, albums | | Spotify | Podcasts only (not music) | | Apple Podcasts | Podcast episodes |

News & Media

| Platform | Notes | |----------|-------| | BBC iPlayer | UK content | | PBS | US public broadcasting | | CBS News | News clips | | NBC | News and shows | | CNN | News clips | | ESPN | Sports clips | | Arte | European culture |

Educational

| Platform | Notes | |----------|-------| | Khan Academy | Free courses | | TED | Talks and playlists | | Udemy | Requires login | | LinkedIn Learning | Requires subscription | | Coursera | Some content |

Other Popular Sites

| Platform | Type | |----------|------| | Bilibili | Chinese video platform | | NicoNico | Japanese video platform | | VK | Russian social network | | Weibo | Chinese social media | | Archive.org | Internet Archive | | Dropbox | Shared videos | | Google Drive | Shared videos | | Steam | Game trailers | | Imgur | Video content |

Full List

For the complete list of 1800+ supported sites, see the official yt-dlp supported sites.

Site-Specific Authentication

Some sites work better with authentication:

# Using .netrc file (recommended for security)
--netrc

# Using username/password directly
--username YOUR_EMAIL --password YOUR_PASSWORD

# Using browser cookies
--cookies-from-browser firefox

Tip: For sites like Vimeo, YouTube (age-restricted), or any subscription service, authentication unlocks more content.

🌐 Web Image Scraper – Site Handlers

The Web Image Scraper node ships with 25+ site-specific handlers that understand each site's DOM structure and extract full-resolution images automatically. A generic handler covers everything else.

| Handler | Sites | Key Features | |---------|-------|--------------| | BellazonHandler | bellazon.com (IPS / Invision Community forums) | Full-res from <a> hrefs (not thumbnails); auto-paginate all topic pages; opens spoiler / hidden-content blocks; collects YouTube & Vimeo video links | | InstagramHandler | instagram.com | Posts, reels, stories; cookie auth | | RedditHandler | reddit.com | Gallery posts, age-gate bypass | | BskyHandler | bsky.app | Bluesky AT Protocol API | | PinterestHandler | pinterest.com | Pin boards, infinite scroll | | FlickrHandler | flickr.com | Original-size downloads | | DeviantArtHandler | deviantart.com | Full-resolution deviations | | ArtStationHandler | artstation.com | Project galleries | | BehanceHandler | behance.net | Project modules | | 500pxHandler | 500px.com | Photo pages | | UnsplashHandler | unsplash.com | Full-res downloads | | TumblrHandler | tumblr.com | Blog posts | | KavyarHandler | kavyar.com | Model portfolios | | CosmosHandler | cosmos.so | Boards & collections | | GoogleArtsHandler | artsandculture.google.com | High-res artwork tiles | | ArtsyHandler | artsy.net | Artwork pages | | ModelMayhemHandler | modelmayhem.com | Portfolio images | | WixHandler | Wix-powered sites | Wix media URLs | | WordPressHandler | WordPress sites | Featured images, galleries | | YouTubeHandler | youtube.com | Thumbnails, channel art | | PortfolioHandler | Generic portfolio sites | Common portfolio layouts | | GenericHandler | Any website | Fallback: extracts all images meeting size thresholds |

IPS / Invision Community Forums (Bellazon)

The BellazonHandler is purpose-built for Invision Community (IPS) forums:

• Full-resolution only — IPS thumbnails use a different hash than the full-res image, so the handler reads the authoritative <a href> and data-full-image attributes instead of trying to rewrite thumbnail URLs.
• Spoiler handling — Automatically opens <details> spoiler blocks ("Spoiler", "Spoiler Nudity", "Reveal hidden contents", etc.) before extraction so hidden images are included.
• Multi-page pagination — Detects "PAGE X OF Y" controls and walks through every page of a topic automatically.
• Video link collection — YouTube and Vimeo URLs embedded in posts are collected and returned as video items for optional download with the yt-dlp node.
• Zero thumbnail downloads — Any URL containing .thumb. is hard-rejected at three levels (JS extraction, Python filter, post-processing).

To add support for another IPS-powered forum, just add its domain to the IPS_DOMAINS list in site_handlers/bellazon_handler.py.

📦 Installation

Using ComfyUI Manager (Recommended)

1. Open ComfyUI Manager
2. Search for "Download Tools"
3. Click Install

Manual Installation

1. Clone or download this repository to your ComfyUI custom_nodes folder:

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

2. Install dependencies:

   # Windows (using ComfyUI's Python)
   .\ComfyUI\python_embeded\python.exe -m pip install -r download-tools\requirements.txt
   
   # Or using system Python
   pip install -r download-tools/requirements.txt
   

3. (Optional) Install FFmpeg for audio extraction:

   • Windows: choco install ffmpeg or download from https://ffmpeg.org/
   • macOS: brew install ffmpeg
   • Linux: apt-get install ffmpeg

4. Restart ComfyUI

🚀 Quick Start

Gallery-dl Downloader

1. Add "Gallery-dl Downloader" node to your workflow
2. Enter a URL (e.g., Instagram profile, Reddit post)
3. Configure options:
   • Set config_path to ./configs/gallery-dl.conf (auto-saved for next time)
   • Enable filter_by_resolution to skip small images (768px default)
   • Enable organize_files to sort by type
   • Enable use_download_archive to avoid duplicates
   • Increase download_timeout for large galleries (default: 600s)
4. Execute!

Supported Sites: Instagram, Reddit, Twitter, DeviantArt, Pixiv, Tumblr, Pinterest, Flickr, and 90+ more. See gallery-dl supported sites.

Yt-dlp Downloader

1. Add "Yt-dlp Downloader" node to your workflow
2. Enter a URL (e.g., YouTube video, Vimeo, Twitch VOD, TikTok)
3. Choose format:
   • best - Best quality video
   • best[height<=1080] - Best quality up to 1080p
   • audio-only - Extract audio (requires FFmpeg)
   • Custom format string
4. For private content, enable browser cookies or use config file with credentials
5. Execute!

Supported Sites: YouTube, Vimeo, TikTok, Twitch, Facebook, Instagram, Twitter, Dailymotion, SoundCloud, and 1800+ more. See yt-dlp supported sites or the table above.

� Instagram Downloads

For Instagram, use Gallery-dl as it is better. Gallery-dl has native Instagram API support, handles pagination, rate limits, and can download posts, stories, reels, and highlights.

Recommended Settings

| Setting | Value | Notes | |---------|-------|-------| | config_path | ./configs/gallery-dl.conf | Contains all site credentials (auto-saved) | | cookie_file | (leave empty) | Cookies are in config file | | use_browser_cookies | ❌ False | Config file is more reliable | | filter_by_resolution | ✅ True | Skip thumbnails and small images | | min_image_width/height | 768 | Minimum resolution in pixels |

One Config For All Sites

The gallery-dl.conf file contains credentials for all supported sites (Instagram, Reddit, 500px, DeviantArt, Pinterest, Flickr, Bluesky). Gallery-dl automatically uses the right credentials based on the URL you're downloading from.

Why Not Browser Cookies?

• Chrome/Edge: Require admin privileges AND browser must be closed
• Firefox: Works without admin, but less reliable than config file
• Config file: Most reliable method - always works

Setting Up Instagram Authentication

1. Export your Instagram cookies from Chrome/Firefox using "Get cookies.txt LOCALLY" extension
2. Copy the key cookies to configs/gallery-dl.conf in the instagram section:

   "instagram": {
       "cookies": {
           "sessionid": "YOUR_SESSION_ID",
           "ds_user_id": "YOUR_USER_ID", 
           "csrftoken": "YOUR_CSRF_TOKEN",
           "mid": "YOUR_MID_VALUE"
       }
   }
   

3. Use in node:
   • Set config_path to ./configs/gallery-dl.conf
   • Leave cookie_file empty
   • Set use_browser_cookies to False

Cookie Expiration

Instagram session cookies expire after ~1 year. If downloads start failing with 401 errors, export fresh cookies from your browser.

�🔐 Authentication

Many sites require authentication for private content:

Method 1: Browser Cookies (Automatic)

1. Log into the website in your browser
2. Enable use_browser_cookies in the node
3. Select your browser (Chrome, Firefox, Edge, etc.)
4. The node will automatically use your login session

Method 2: Export Cookies

1. Install browser extension: "Get cookies.txt LOCALLY"
2. Log into the website
3. Export cookies
4. Save to configs/instagram_cookies.json (or site-specific file)
5. Set cookie_file parameter in the node

📁 Configuration

Config files are stored in download-tools/configs/:

• gallery-dl.conf - Main config with credentials for all sites (Instagram, Reddit, 500px, DeviantArt, Pinterest, Flickr, Bluesky)
• gallery-dl.conf.example - Template for creating your own config
• yt-dlp.conf.example - Yt-dlp template (copy to yt-dlp.conf and add your credentials)
• yt-dlp-audio.conf - Audio extraction preset
• yt-dlp-hq.conf - High quality preset

Persistent Paths

Config file paths are automatically saved between ComfyUI sessions. Once you set config_path or cookie_file, they'll be remembered for next time.

📚 Documentation

Detailed guides available in Docs/:

• gallery_dl_node_complete_guide.md - Complete gallery-dl usage
• yt_dlp_node_complete_guide.md - Complete yt-dlp usage
• gallery_dl_authentication_guide.md - Authentication setup
• gallery_dl_advanced_options_guide.md - Advanced features

🐛 Troubleshooting

"gallery-dl not found"

Already installed! It's a Python package. The node will find it automatically.

"Chrome cookies not accessible"

Chrome locks its cookie database while running. Solutions:

• Close Chrome completely before running
• Run ComfyUI as administrator
• Use Firefox instead (doesn't require admin)
• Best: Use config file with cookies (see Instagram section above)

"Instagram/Reddit downloads fail"

Authentication required:

• Use config_path: ./configs/gallery-dl.conf with cookies
• Or enable use_browser_cookies with Firefox
• 401 Unauthorized = expired cookies, export fresh ones

"Downloads timing out"

For large galleries:

• Increase download_timeout (default: 1800s / 30 min, max: 10 hours)
• Large Instagram profiles may need several hours
• If a download times out, just run again — gallery-dl automatically resumes using the download archive

"Too many small images"

Enable resolution filtering:

• Set filter_by_resolution to True
• Adjust min_image_width and min_image_height (default: 768px)
• Videos are never filtered, only images

"CUDA out of memory" / "FFmpeg not found"

For audio extraction:

• Install FFmpeg separately
• Or use video formats

⚙️ Requirements

• Python 3.10+
• ComfyUI
• gallery-dl (auto-installed)
• yt-dlp (auto-installed)
• FFmpeg (optional, for audio extraction)

📄 License

Copyright (c) 2025 Eric Hiss. All rights reserved.

Dual License:

• Non-Commercial Use: Licensed under Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0)
• Commercial Use: Requires a separate commercial license. Contact: [email protected] or [email protected]

See LICENSE.md for full terms.

Third-Party Tools

• gallery-dl (GNU GPL v2) by Mike Fährmann: https://github.com/mikf/gallery-dl
• yt-dlp (Unlicense/Public Domain): https://github.com/yt-dlp/yt-dlp

See CREDITS.md for complete dependency list.

👥 Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

📧 Contact

• Author: Eric Hiss
• GitHub: EricRollei
• Email: [email protected], [email protected]

🙏 Acknowledgments

• ComfyUI community for the platform
• Mike Fährmann for gallery-dl
• yt-dlp contributors for the excellent video downloader

---

Ready to download! 🚀 Add the nodes to your workflow and start downloading media from across the web.