Rate Limiting Options

These are limiting options for the program

connection_timeout

Type	Default
PositiveInt	15

The number of seconds to wait while connecting to a website before timing out

This value will also be used for Flaresolverr (if enabled) as the max number of seconds to solve a CAPTCHA challenge

download_attempts

Type	Default
PositiveInt	2

The number of download attempts per file. Some conditions are never retried (such as a 404 HTTP status)

download_delay

Type	Default
NonNegativeFloat	0.0

This is the number of seconds to wait between downloads to the same domain.

Some domains have internal limits set by the program, which can not be modified:

• bunkr: 0.5

• coomer: 0.5

• kemono: 0.5

• nhentai.net: 1

download_speed_limit

Type	Default
ByteSize	0

This setting specifies speed and it's interpreted as <value> / second. ex: 8MB means 8MB/s

This is the max rate of downloading in bytes (per second) for all downloads combined. Set to 0 to disable

file_host_cache_expire_after

Type	Default
timedelta, str or int	7 days

Cyberdrop-DL caches the requests made to any website. This setting controls how long responses to file host websites are stored before expiring.

• A timedelta input is expected to be a valid ISO 8601 timespan, ex: P10DT2H30M10S

• An int input is assumed to be the number of days

• A str input is expected to be in the format; <value> <unit>, ex: 10 days.

Valid str units

• year(s)

• month(s)

• week(s)

• day(s)

• hour(s)

• minute(s)

• second(s)

• millisecond(s)

• microsecond(s)

You can set the value to 0 to disable caching

forum_cache_expire_after

Type	Default
timedelta, str or int	4 weeks

Same as file_host_cache_expire_after but applied to forums requests.

jitter

Type	Default
NonNegativeFloat	0.0

Additional number of seconds to wait in between downloads. CDL will wait an additional random number of seconds in between 0 and the jitter value.

max_simultaneous_downloads

Type	Default
PositiveInt	15

This is the maximum number of files that can be downloaded simultaneously.

max_simultaneous_downloads_per_domain

Type	Default
PositiveInt	5

This is the maximum number of files that can be downloaded from a single domain simultaneously.

Some domains have internal limits set by the program, which can not be modified:

• bunkr: 1 per unique server

• cyberfile: 1

• noodlemagazine: 2

• 4chan: 1

• pixeldrain: 2

• xxxbunker: 2

rate_limit

Type	Default
PositiveFloat	50.0

This setting specifies speed and it's interpreted as <value> / second. ex: 50 means 50 requests / second

This is the maximum number of requests that can be made by the program per second.

read_timeout

Type	Default
PositiveFloat or null	300.0

The number of seconds to wait while reading data from a website before timing out. A null value will make CDL keep the socket connection open indefinitely, even if the server is not sending data anymore