Skip to content
SpiffyChatterbox edited this page Sep 21, 2024 · 2 revisions

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"

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