gallery-dl

library1.32.3pypypi✓ verified 86d ago

gallery-dl is a command-line program designed to download image galleries and collections from a wide range of image hosting sites. It is actively maintained with frequent updates, primarily to address changes in website structures and add support for new sites. The current version is 1.31.10, and it maintains a rapid release cadence.

http-networking data

pip install gallery-dl

package ↗homepage ↗

INSTALL

IMPORT

SIG · GALLERY-DL

gallery-dl

http-networkingpythonv1.32.3

Install

2.7s avg

Import

170ms

Disk

26MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.32.3 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.920 runs

installs and imports cleanly · install 0.0s · import 0.173s · 27.3MB

glibc

py 3.10–3.920 runs

installs and imports cleanly · install 2.7s · import 0.168s · 28MB

26MB installed

● package 26MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

main

✓ from gallery_dl import main

While primarily a CLI tool, `gallery_dl.main.main()` can be called programmatically, typically with a list of arguments mimicking command-line input. It is generally advised to use it via the command line.

Downloads all available images from a public Imgur gallery, saving them to the current directory.

gallery-dl "https://imgur.com/gallery/1324567"

gallery-dl --version

Debug

Known issues

breakingExtractors for specific websites frequently break due to upstream changes on those sites (e.g., API changes, HTML structure modifications), leading to download failures or incomplete data.

fix

Regularly update to the latest `gallery-dl` version (`pip install --upgrade gallery-dl`). If the issue persists after updating, check the official GitHub issues for known problems with the specific site or report a new one.

affects: All versions, as this is inherent to the nature of web scraping.

gotchaAuthentication for many sites requires manually acquiring and providing cookies or login credentials. These methods can be site-dependent, may require browser extensions, and can change without notice.

fix

Consult the `gallery-dl` documentation for the specific site you are trying to download from regarding authentication methods. Common approaches include using `--cookies` with a Netscape-formatted cookie file or `--username`/`--password` options if supported.

affects: All versions.

deprecatedAs of v1.31.10, DeviantArt 'original' downloads are disabled by default. This change might result in lower-quality images being downloaded unless explicitly configured.

fix

To enable original DeviantArt downloads, you may need to adjust your configuration or use specific command-line options. Refer to the DeviantArt extractor documentation within `gallery-dl` for details on how to re-enable this feature.

affects: >=1.31.10

Errors

Common errors & fixes

gallery-dl: error: unrecognized arguments: https://some.site/url with spaces

The URL contains characters (like spaces or shell metacharacters such as '&') that are interpreted by the shell as separate arguments, or the URL itself is not properly quoted.

fix

Always wrap URLs in double quotes (e.g., `gallery-dl "https://some.site/url with spaces"`) to ensure the shell passes the entire URL as a single argument to `gallery-dl`.

ERROR: [extractor-name] An unexpected error occurred: KeyError: 'data'

The website's structure has changed, and the `gallery-dl` extractor for that site is outdated and cannot find expected data elements.

fix

This typically indicates a broken extractor. Upgrade `gallery-dl` to the latest version (`pip install --upgrade gallery-dl`). If the issue persists, check the GitHub issues for `gallery-dl` to see if a fix is in progress or report a new issue.

ERROR: [extractor-name] Login required

You are attempting to download content that requires authentication without providing valid credentials (e.g., cookies or login details).

fix

Provide authentication credentials. For many sites, this means using a cookies file (e.g., `--cookies cookies.txt`) generated by a browser extension. Refer to the `gallery-dl` documentation for the specific site's authentication requirements.

Upgrade

Version history

1.32.3latest on PyPI · released Jun 13, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

7 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/gallery-dl/ ↗

homepagehttps://codeberg.org/mikf/gallery-dl ↗