Frequently Asked Questions

Common questions or problems.

What does this do?

This is a bulk downloader for the supported sites. It supports resumable downloading (you can close and reopen the program at any time and it will pick up where it left off), and keeps track of your download history to avoid downloading files you've already downloaded in the past.

How do I update this?

If you are using one of the provided start files, it should do so automatically, if it doesn't open up terminal or command prompt and do the following:

pip install --upgrade cyberdrop-dl

if you are on mac you may need to do the following:

pip3 install --upgrade cyberdrop-dl

Where is the Downloader.log file?

If you are running using one of the new start scripts it'll be in ./appdata/configs/<config>/logs/

What do the Scrape Failures and Download Failures mean?

Quite simply, almost all of them you see will be HTTP Status codes. Such as: 404 - Not Found (dead link)

You can google what the individual HTTP status' mean.

Any "Unknown" error, is usually coding related, or it'll be something like the program not being able to find a file extension for a file.

Why are all the files skipped?

By default Cyberdrop-DL keeps track of your download history and will skip all files that you've downloaded in the past to avoid duplicates. You can turn off the behavior by using the --ignore-history cli arg, or ignore_history in the config.

The screen is flickering?

You can likely blame Microsoft for this one and how ancient the traditional command prompt is. If you are windows 10 I highly suggest you install and use Windows Terminal to run Cyberdrop-DL. Terminal is the default on Windows 11.

Cyberdrop-DL is not a recognized internal command

This is caused by an improper installation of python. Specifically python not being added to path.

I'd recommend you go back to the quick start guide and follow the steps it says to reinstall python.

Quick Start

How do I scrape forum threads?

You need to provide Cyberdrop-DL with your credentials or user cookies in order to scrape forums.

You can do this in the UI by selecting 'Manage Configs' -> 'Edit Authentication Values'

Then you can select whether you want to extract cookies from your browser automatically, or provide the details yourself.

Why are the filenames the way they are?

Filenames are taken from the website you are trying to download from. Blame whoever uploaded it.

How do I fix `[SSL: CERTIFICATE_VERIFY_FAILED]`

This should only appear on mac, so these instructions are for mac users.

Go to your applications folder, find the python folder inside of it. Run the Install Certificates file in that folder.

Go back to where you are running Cyberdrop-DL and delete the the venv folder if one exists (if not, don't worry). Then try running the program again.

How do I go back to V4?

In the start file change the pip install --upgrade cyberdrop-dl line to read pip install cyberdrop-dl==4.2.231

V4 will not receive any new updates. V5 is the only way forward.

Last updated