Usage

Usage

To use gallery-dl simply call it with the URLs you wish to download images from:

gallery-dl [OPTIONS]... URLS...

Use gallery-dl --help or see docs/options.md for a full list of all command-line options. Examples

Download images; in this case from danbooru via tag search for 'bonocho':

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

Get the direct URL of an image from a site supporting authentication with username & password:

gallery-dl -g -u "<username>" -p "<password>" "https://twitter.com/i/web/status/604341487988576256"

Filter manga chapters by chapter number and language:

gallery-dl --chapter-filter "10 <= chapter < 20" -o "lang=fr" "https://mangadex.org/title/59793dd0-a2d8-41a2-9758-8197287a8539"

Gallery-DL can keep track of the websites you download from, to save you from having to download this in the future. ths is known as "archive" mode, and must be enabled in your options:

gallery-dl "https://website.com" --download-archive archive.sqlite3

Search a remote resource for URLs and download images from them: (URLs for which no extractor can be found will be silently ignored)

gallery-dl "r:https://pastebin.com/raw/FLwrCYsT"

If a site's address is nonstandard for its extractor, you can prefix the URL with the extractor's name to force the use of a specific extractor:

gallery-dl "tumblr:https://sometumblrblog.example"

To tunnel through a SOCKS proxy, use the --proxy command, and a SOCKS schema-formatted address:

gallery-dl --proxy socks5h://192.168.1.1:5555 

To exclude specific filetypes, you can filter extensions. For example, if youw ant to download everything except images, you would use:

gallery-dl --filter "extension not in ('jpg', 'png', 'bmp')" "https://samplewebsite.com/"