Skip to content

Frequently Asked Questions

SpiffyChatterbox edited this page Aug 11, 2024 · 8 revisions

Is this tool right for me?

Gallery-dl is not for everybody or every situation.

It is a command-line tool that requires you to install Python, read and understand mildly technical documentation, edit configuration files, and do a little tinkering to get it to work.

It is excellent at downloading files from supported sites. Generally that means images, videos, comics, and manga, but not strictly. It is not a viewer or file manager; you will need another tool for that.

It can keep track of which files you have downloaded so you can "watch" an album or user and don't need to download duplicate files. But it does not do that automatically; you need to know how to script and schedule it, or run it manually.

This is not the right tool for torrenting or private trackers.

Does it support this one site I use or can you add it?

Today, gallery-dl supports hundreds of sites! All of the sites listed in the Supported Sites list work out of the box using the Basic Usage instructions.

If your site is similar to other sites, you can do a custom configuration to add your site. See the Custom Site Support page for details.

You can also develop your own extractor! If you have a moderate level of Python experience, we are creating instructions to walk you through how to setup your own. We love to have new sites added.

As a last resort, you can post an issue asking for your site to be supported. As we are a volunteer community, these take a while to get to. Please search the issues list to see if your site has already been posted to prevent duplicating requests.

Can it monitor for changes to files?

In general, no. gallery-dl downloads files based on their name. It does not recognize updated modification dates or different file versions. If you downloaded a file from one URL and have configured it to "skip":true, then it will not attempt to download another file at the same URL.

Can it detect or remove duplicate files?

No. It downloads files and albums from the URLs you provide, and saves them in a folder structure based on the site it was downloaded from. (Save location can be configured, but this is it's default action.) It does not recognize the files or take action for duplicate or similar files.