gallery-dl
- title
- gallery-dl
- type
- toolbox
- summary
- Command-line downloader for image galleries across hundreds of sites — yt-dlp for pictures
- tags
- python, downloader, media, cli
- language
- Python
- license
- GPL-2.0
- created
- 2026-04-06
- updated
- 2026-04-06
Command-line tool for downloading image galleries and collections from a wide range of hosting sites — Pixiv, Twitter, Tumblr, DeviantArt, Danbooru, MangaDex, Kemono, and many others. Think yt-dlp but for image galleries instead of video.
How it works: gallery-dl uses per-site extractors that understand each platform's page structure and API. You give it a URL, it figures out which extractor to use, walks the gallery/collection, and downloads everything with configurable file naming. It can also be pointed at yt-dlp for sites that serve video in HLS/DASH formats.
Basic usage:
# download a gallery
gallery-dl https://twitter.com/user/media
# force a specific extractor
gallery-dl tumblr:https://example.com
# filter manga chapters by number and language
gallery-dl --chapter-filter "10 <= num < 20" --option lang=en URL
Configuration: JSON config files at ~/.config/gallery-dl/config.json (Linux/macOS) or %APPDATA%\gallery-dl\config.json (Windows). Multiple config files can be layered, later values override earlier ones.
Authentication: supports username/password, cookies (Mozilla format or extracted from browsers), and OAuth flows for Pixiv, DeviantArt, Flickr, Reddit, and others. Run gallery-dl oauth:sitename to get tokens.
Optional dependencies: yt-dlp for video, FFmpeg for Pixiv animations, PySocks for SOCKS proxies, PostgreSQL via psycopg for archive databases.
Install: pip, Homebrew, Snap, Chocolatey, Scoop, Docker, Nix, or standalone binaries for Windows/Linux.
Repo: https://github.com/mikf/gallery-dl — 17.5k stars, GPL-2.0 license.