home / media / gallery-dl

gallery-dl

17k

Media download CLI for fetching images, videos, and metadata from supported gallery, creator, and social media URLs.

$python3 -m pip install -U gallery-dl
Language
Python
Stars
17,094
Category
Media & Video
Agent
Ready
Agent Compatibility
JSON Output
Agent Skill
MCP Support
AI Analysis

gallery-dl is a URL-driven downloader for pulling media and metadata from a large catalog of supported sites, including galleries, creator pages, boards, posts, and collections. It is built around extractor modules and deep configuration rather than a human-first interactive flow.

What It Enables
  • Download images, videos, and attached metadata from supported gallery, creator, forum, and social media URLs.
  • Queue URLs from stdin or files, filter by ranges, dates, tags, or custom expressions, and keep state with archives and cache files.
  • Extract direct file URLs or structured metadata without downloading, then feed the results into other shell tools.
Agent Fit
  • Non-interactive flags, input-file support, and config-driven authentication make it workable in unattended batch jobs.
  • Real structured output exists via -j/--dump-json, -J/--resolve-json, and optional JSON Lines mode for downstream parsing.
  • Fit is mixed by site-specific extractor reliability: protected sources often need cookies or browser state, and upstream site changes can break workflows.
Caveats
  • Some video and conversion flows depend on extra tools such as yt-dlp, ffmpeg, or mkvmerge.
  • Support is extractor-by-extractor, so coverage and stability vary by site.