# Rate Limiting Options

## `connection_timeout`

| Type          | Default |
| ------------- | ------- |
| `PositiveInt` | `15`    |

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

{% hint style="info" %}
This value will also be used for Flaresolverr (if enabled) as the max number of seconds to solve a CAPTCHA challenge
{% endhint %}

## `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`     |

{% hint style="info" %}
This setting specifies speed and it's interpreted as `<value> / second`. ex: `8MB` means `8MB/s`
{% endhint %}

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)`

{% hint style="info" %}
You can set the value to `0` to disable caching
{% endhint %}

## `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` | `25.0`  |

{% hint style="info" %}
This setting specifies speed and it's interpreted as `<value> / second`. ex: `25` means `25 requests / second`
{% endhint %}

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://script-ware.gitbook.io/cyberdrop-dl/reference/configuration-options/global-settings/rate-limiting-options.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.