# gallery-dl

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:**

```sh
# 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.