Media download CLI for fetching images, videos, and metadata from supported gallery, creator, and social media URLs.
$python3 -m pip install -U gallery-dl
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, ormkvmerge. - Support is extractor-by-extractor, so coverage and stability vary by site.