gallery-dl

Download images from the specified URL

$ gallery-dl "[url]"

$ gallery-dl --destination [path/to/directory] "[url]"

$ gallery-dl --cookies-from-browser [browser] "[url]"

$ gallery-dl --get-urls --username [username] --password [password] "[url]"

$ gallery-dl --chapter-filter "[10 <= chapter < 20]" --option "lang=[language_code]" "[url]"

gallery-dl [OPTIONS]... URL [URL...]

-h, --help
    Show help message and exit

-V, --version
    Print program version and exit

-v, --verbose
    Enable verbose output (repeat for more verbosity)

-q, --quiet
    Suppress non-essential output

-d DIR, --dest DIR
    Set base destination directory

-D PATH, --directory PATH
    Path template for output directory

-f FORMAT, --filename FORMAT
    Filename format template

-c PATTERN, --chapter-pattern PATTERN
    Regular expression for chapter selection

-r RANGE, --range RANGE
    File number range (e.g., '1-10)

--filter EXPR
    Python expression to filter files

-o KEY=VALUE, --option KEY=VALUE
    Set extractor option

--config FILE
    Load configuration from FILE

--cookies-from-browser BROWSER
    Load cookies from BROWSER (e.g., chrome)

-i, --ignore-errors
    Continue on extractor errors

-a, --abort-after NUMBER
    Abort after NUMBER failed files

--rate-limit NUMBER
    Limit requests per second

--external-downloader CMD
    Use external downloader command

--write-info-json
    Write metadata to .json file

--no-download
    Do not download files (dry-run)

gallery-dl is a cross-platform command-line program designed to download image galleries, manga, and collections from hundreds of websites, including Pixiv, DeviantArt, Tumblr, Twitter, Instagram, and more.

It supports batch downloading of albums, user profiles, tags, and feeds using flexible URL patterns and keyword extraction. Output is highly customizable via directory and filename templates, filters, ranges, and post-processing hooks. Metadata like titles, descriptions, tags, and thumbnails are extracted and can be embedded in files.

Configuration is done through CLI options, JSON config files (~/.config/gallery-dl/config.json), or environment variables. It respects robots.txt by default, handles rate limiting, retries failed downloads, and supports external downloaders like aria2c. Ideal for archiving artwork, comics, and social media content efficiently.

Many sites enforce rate limits or require login/cookies; use --cookies-from-browser. Respects robots.txt by default (disable with extractor options). Large archives may consume significant disk space and bandwidth.

Install via pip install --user gallery-dl or from package managers (e.g., apt install gallery-dl on Debian). Requires Python 3.7+

Edit ~/.config/gallery-dl/config.json for site-specific options, templates, and defaults. See 'gallery-dl --help-config'.

Use {title}, {id}, {num}, {extension} in templates. Full list via 'gallery-dl --help-keywords'.

Originally developed in 2016 by Mike Crawford as a Python script. Actively maintained since 2017 by NikkyLin2008 on GitHub with regular updates for new sites, bug fixes, and Python 3.8+ support. Widely used for bulk art/manga archiving.

wget(1), curl(1), yt-dlp(1), aria2c(1)