Skip to content

Bulk asynchronous downloader for multiple file hosts

1.6 KB
Raw Blame

icon: sliders description: Here's how configuration works.

You can setup a configuration file to customize the default behaviour of cyberdrop-dl. All CLI options have a config equivalent but some options (like account credentials) can only be provided using a config file.

The config file format is YAML and it must have a .yaml or .yml extension. If a config file does not exists, cyberdrop-dl will use its internal defaults.

You can manually create a config with all the default settings using the Edit config option on the main menu or running the command cyberdrop-dl config new

cyberdrop-dl will always look for a config file at these default locations:

  • Windows: %AppData%/cyberdrop-dl/config.yaml
  • macOS/Linux/Android: ${XDG_CONFIG_HOME}/cyberdrop-dl/config.yaml or ~/.config/cyberdrop-dl/config.yaml

You can also provide a config file manually via the --config-file CLI argument. If provided, the default config file will be ignored. A file provided by --config-file must exists already. cyberdrop-dl will refuse to run otherwise.

Config files can have partial settings. You do not have to specific every single option in the file, just the ones you want to use/override.

The following is a valid config that specifies only 2 settings:

dump_json: true
ignore_history: true

{% hint style="info" %} Options provided via CLI arguments will always take priority over config options.

Options will apply in this order:

CLI Options > options from --config-file (if provided) > options from default config file (if it exists) > Internal defaults of the program {% endhint %}