---
id: gallery-dl
version: "1.32.9"
license: GPL-2.0-only
license_treatment: copyleft
maintenance: active
---

# gallery-dl — Command-line program to download image galleries and collections from several image hosting sites

License: copyleft · Maintenance: active · Downloads: 400.8K/mo

## What it is and what it does

gallery-dl is a command-line downloader for image galleries and collections hosted on multiple image sites. It accepts URLs, identifies the hosting site, and downloads all media in that collection to local storage. The tool supports cross-platform operation and offers extensive configuration through command-line flags and JSON configuration files, including filtering by metadata (chapter number, language, tags), custom file naming using template syntax, and authentication where required.

The package depends only on requests for HTTP operations, making installation straightforward. It includes optional support for video downloads (via yt-dlp or youtube-dl), advanced compression formats, YAML/TOML configuration parsing, and system keyring integration for stored credentials. The tool is actively maintained and supports current Python versions.

Use it for:

- Download all images from a Danbooru tag search or similar image board in one command
- Batch retrieve manga chapters from MangaDex with filtering by chapter range and language
- Extract images from a Twitter thread or other social media gallery with authentication
- Organize downloaded images using custom naming templates based on metadata like artist, date, or tags
- Automate recurring downloads from multiple galleries using configuration files and scheduled runs

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A command-line tool that downloads image galleries and collections from multiple image hosting sites by parsing URLs and extracting media with configurable naming and filtering.

Yes, if you need to download image galleries from supported hosting sites. The tool is actively maintained, has minimal dependencies, and supports current Python versions. The copyleft GPL-2.0-only license is permissive for personal use but requires attention if you plan to redistribute or embed it in proprietary software. No known security vulnerabilities.

## Install

pip install gallery-dl
uv add gallery-dl
poetry add gallery-dl

## Installing gallery-dl

Before you install: Low install friction with a single runtime dependency (requests). Active maintenance with a release 13 days ago. Supports modern Python versions (3.8 through 3.14) and runs on CPython and PyPy.

License in practice: Licensed under GPL-2.0-only (copyleft). Any derivative work or distribution must also be released under GPL-2.0-only; using this in proprietary software requires careful licensing review.

Quickstart:

pip install gallery-dl
gallery-dl "https://danbooru.donmai.us/posts?tags=bonocho"

Requires Python 3.8 or later. Some features (video downloads, compression formats, browser cookies) require optional dependencies like yt-dlp, FFmpeg, brotli, or SecretStorage.

Verify before relying:

- Whether the package handles rate-limiting or respects site robots.txt/terms of service by default
- Performance characteristics when downloading very large galleries (thousands of images)
- Specific list of all supported image hosting sites beyond the reference to external documentation

## Package facts

- License: GPL-2.0-only (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 400.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

image gallery downloader, bulk image scraper, site image crawler, batch download images, gallery extraction tool, image collection downloader, web image harvester, cli-tool, web-scraping, batch-download

[View on SkillFed](https://skillfed.io/packages/gallery-dl) · [View on PyPI](https://pypi.org/project/gallery-dl/)