General

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

allow_insecure_connections

Type	Default
bool	false

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

This will make the connection insecure, and sensitive data may be exposed. You should only enable this option if you know what you are doing. For your safety, is recommended to always use a secure HTTPS connection to protect your privacy.

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://ip:port

This wiki does not covert flaresolverr setup process. If you need help, refer to their documentation. Please refrain from opening issues related to flaresolverr.

max_file_name_length

Type	Default
PositiveInt	95

This is the maximum number of characters allowable in a filename.

max_folder_name_length

Type	Default
PositiveInt	95

This is the maximum number of characters allowable in a folder name.

pause_on_insufficient_space

Type	Default
bool	false

Setting this to true will make CDL pause if there not enough free space available.

CDL will only pause once. After the user resumes, every InsufficientFreeSpaceError will be propagated

proxy

Type	Default
HttpURL or null	null

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

required_free_space

Type	Default	Restrictions
ByteSize	5GB	>=512MB

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

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, determining how it is presented to the websites you visit.. You can google "what is my user agent" to see what yours may be.

If you use flaresolverr, this value must match with flaresolverr user agent for its cookies to work