General

These are some general settings that will be used regardless of which config is loaded

disable_crawlers

Type	Default	Additional Info
list[NonEmptyStr]	[]	This is an AdditiveArg

You can supply a list of crawlers to disable for the current run. This will make CDL completely ignore the crawler, as if the site was not supported. However, links from the site will still be processed by Real-Debrid (if enabled), Jdownloader (If enabled) and the Generic crawler (If enabled), in that order.

The list should be valid crawlers names. The name of the crawler is the name of the primary site they support. ex: 4Chan, Bunkrr, Dropbox Crawlers names correspond to the column site in the supported sites page.

enable_generic_crawler

Type	Default
bool	true

CDl has a generic crawler that will try to download from unsupported sites. Setting this to false will disable it.

CDL will still try to download from unsupported URLs if the last part of the URL has a known file extension. ex: .jpg

flaresolverr

Type	Default
HttpURL or null	null

FlareSolverr is a proxy server to bypass Cloudflare and DDoS-Guard protection. The provided value must be a valid http URL of an existing flaresolverr instance. Ex: http://192.168.1.44:4000

0.0.0.0 is NOT a valid IP address. To set up a flaresolverr instance running on the same machine as CDL, use 127.0.0.1 as the IP

This wiki does not cover flaresolverr setup process. If you need help, refer to their documentation. Please do not open issues related to flaresolverr or DDoS-Guard. See: How to extract cookies (DDoSGuard or login errors) #839 for alternatives using cookies

max_file_name_length

Type	Default
PositiveInt	95

This is the maximum number of characters filename should have. CDL will truncate filenames longer that this.

max_folder_name_length

Type	Default
PositiveInt	95

This is the maximum number of characters a folder should have. CDL will truncate folders longer that this.

proxy

Type	Default
HttpURL or null	null

The proxy you want CDL to use. Only http proxies are supported. Ex: https://user:password@ip:port

required_free_space

Type	Default	Restrictions
ByteSize	5GB	>=512MB

This is the minimum amount of free space require to start new downloads.

If you set a value lower than 512MB, CDL will override it with 512MB

ssl_context

Type	Default
NonEmptyStr or None	truststore+certifi

Context that will used to verify SSL connections. Valid values are:

• truststore: Will use certificates already included with the OS

• certifi: Will use certificates bundled with the certifi version available at the release of the current CDL version

• truststore+certifi: Will use certificates already included with the OS, with a fallback to certifi for missing certificates

• None: Will completly disable SSL verification, allowing secure connections.

Setting this to None will allow the program to connect to websites without SSL encryption (insecurely).

Sensitive data may be exposed using an insecure connection. For your safety, is recommended to always use a secure HTTPS connection.

user_agent

Type	Default
NonEmptyStr	Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:133.0) Gecko/20100101 Firefox/133.0

The user agent is the signature of your browser. Some sites use it to identify if the requests come from a human or a robot. You can google "what is my user agent" to get yours.

If you use flaresolverr, this value MUST match with flaresolverr's user agent. Otherwise, flaresolverr cookies won't work