gallery-dl/docs/options.md

Command-Line Options

General Options

-h	--help	Print this help message and exit
	--version	Print program version and exit
-i	--input-file	Download URLs found in FILE (- for stdin). More than one --input-file can be specified
-d	--destination	Target location for file downloads
-D	--directory	Exact location for file downloads
-f	--filename	Filename format string for downloaded files (/O for "original" filenames)
	--proxy	Use the specified proxy
	--source-address	Client-side IP address to bind to
	--user-agent	User-Agent request header
	--clear-cache	Delete cached login sessions, cookies, etc. for MODULE (ALL to delete everything)
	--cookies	File to load additional cookies from
	--cookies-from-browser	Name of the browser to load cookies from, with optional keyring name prefixed with +, profile prefixed with :, and container prefixed with :: (none for no container)

Output Options

-q	--quiet	Activate quiet mode
-v	--verbose	Print various debugging information
-g	--get-urls	Print URLs instead of downloading
-G	--resolve-urls	Print URLs instead of downloading; resolve intermediary URLs
-j	--dump-json	Print JSON information
-s	--simulate	Simulate data extraction; do not download anything
-E	--extractor-info	Print extractor defaults and settings
-K	--list-keywords	Print a list of available keywords and example values for the given URLs
	--list-modules	Print a list of available extractor modules
	--list-extractors	Print a list of extractor classes with description, (sub)category and example URL
	--write-log	Write logging output to FILE
	--write-unsupported	Write URLs, which get emitted by other extractors but cannot be handled, to FILE
	--write-pages	Write downloaded intermediary pages to files in the current directory to debug problems

Downloader Options

-r	--limit-rate	Maximum download rate (e.g. 500k or 2.5M)
-R	--retries	Maximum number of retries for failed HTTP requests or -1 for infinite retries (default: 4)
	--http-timeout	Timeout for HTTP connections (default: 30.0)
	--sleep	Number of seconds to wait before each download. This can be either a constant value or a range (e.g. 2.7 or 2.0-3.5)
	--sleep-request	Number of seconds to wait between HTTP requests during data extraction
	--sleep-extractor	Number of seconds to wait before starting data extraction for an input URL
	--filesize-min	Do not download files smaller than SIZE (e.g. 500k or 2.5M)
	--filesize-max	Do not download files larger than SIZE (e.g. 500k or 2.5M)
	--chunk-size	Size of in-memory data chunks (default: 32k)
	--no-part	Do not use .part files
	--no-skip	Do not skip downloads; overwrite existing files
	--no-mtime	Do not set file modification times according to Last-Modified HTTP response headers
	--no-download	Do not download any files
	--no-postprocessors	Do not run any post processors
	--no-check-certificate	Disable HTTPS certificate validation

Configuration Options

-c	--config	Additional configuration files
-o	--option	Additional <key>=<value> option values
	--ignore-config	Do not read default configuration files

Authentication Options

-u	--username	Username to login with
-p	--password	Password belonging to the given username
	--netrc	Enable .netrc authentication data

Selection Options

	--download-archive	Record all downloaded or skipped files in FILE and skip downloading any file already in it
-A	--abort	Stop current extractor run after N consecutive file downloads were skipped
-T	--terminate	Stop current and parent extractor runs after N consecutive file downloads were skipped
	--range	Index range(s) specifying which files to download. These can be either a constant value, range, or slice (e.g. 5, 8-20, or 1:24:3)
	--chapter-range	Like --range, but applies to manga chapters and other delegated URLs
	--filter	Python expression controlling which files to download. Files for which the expression evaluates to False are ignored. Available keys are the filename-specific ones listed by -K. Example: --filter "image_width >= 1000 and rating in (s, q)"
	--chapter-filter	Like --filter, but applies to manga chapters and other delegated URLs

Post-processing Options

	--zip	Store downloaded files in a ZIP archive
	--ugoira-conv	Convert Pixiv Ugoira to WebM (requires FFmpeg)
	--ugoira-conv-lossless	Convert Pixiv Ugoira to WebM in VP9 lossless mode
	--ugoira-conv-copy	Convert Pixiv Ugoira to MKV without re-encoding any frames
	--write-metadata	Write metadata to separate JSON files
	--write-info-json	Write gallery metadata to a info.json file
	--write-tags	Write image tags to separate text files
	--mtime-from-date	Set file modification times according to date metadata
	--exec	Execute CMD for each downloaded file. Example: --exec convert {} {}.png && rm {}
	--exec-after	Execute CMD after all files were downloaded successfully. Example: --exec-after cd {} && convert * ../doc.pdf
-P	--postprocessor	Activate the specified post processor