Cyberdrop-DL Install

Using Start Scripts (From Release Page)

This is the simplest method to get the program up and running. Pre-configured start files are provided that will automatically install python, install cyberdrop-dl, update, and launch the program for you.

The start scripts only work on 64bits operating systems. If you are running a 32bit OS, you need to install directly from pypi and may need to compile some dependencies

You can download them here: https://github.com/jbsparrow/CyberDropDownloader/releases/latest

You only need to download the Cyberdrop-DL_<version>.zip file, you don't need to worry about the other files.

Extract the contents of the zip file to any location where you'd like the program to run and store downloaded files. The extracted files will include a start file for Windows, macOS, and Linux

If you're using Windows or Linux, simply open the start file, and it will handle the rest for you

If you are using Windows, DO NOT run the script as admin

On macOS, you should be able to open the start file and have everything set up automatically. However, in some rare cases, macOS users may need to run the following command first::

xcode-select --install

Optional: Running Cyberdrop-DL Script with Custom Parameters

You can open the start script from the zip in a text editor like notepad. At the top of the file, you will this line:

set "COMMANDLINE_ARGS="

COMMANDLINE_ARGS: Provide any arguments to pass to Cyberdrop-Dl. For more information, refer to the CLI Arguments section

You MUST put the values inside the double quotes. Ex: set "COMMANDLINE_ARGS=--disable-cache"

Manual Install

1. Using uv

The recommended way to install Cyberdrop-DL is using uv.

macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Once you have uv, you can install Cyberdrop-DL using:

uv tool install cyberdrop-dl-patched

2. Manual Python Install

If you do not want to or can't use uv, you will need to install a compatible python version manually.

If you don't have python, you can find and download it from their official website: https://www.python.org/downloads/

Cyberdrop-DL requires python 3.11, 3.12 or python 3.13. The RECOMMENDED version is 3.12+

If you are using a version of Cyberdrop-DL from the previous repository (cyberdrop-dl instead of cyberdrop-dl-patched), you MUST uninstall it before installing the patched version.

pip uninstall cyberdrop-dl

Once you have python, you can install Cyberdrop-DL directly from pypi using pipx or pip. In a command prompt/terminal window:

pipx

• Install pipx (if you don't have it already)

pip install pipx

• Install cdl

pipx install cyberdrop-dl-patched

pip

Using bare pip to install cyberdrop-dl-patched is discouraged as it may lead to dependency conflicts with global installs and an inconsistent environment. Consider using uv or pipx

pip install cyberdrop-dl-patched