Cyberdrop DL

https://script-ware.gitbook.io/cyberdrop-dl
Admin
Cyberdrop DL is an open-source asynchronous downloader for various sites, allowing users to bulk...
Tokens:53,767
Snippets:996
Trust Score:9.8
Update:3 months ago
Show doc for...
Tokens:
Raw
### Install Xcode Command Line Tools on macOS

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/getting-started/cyberdrop-dl-install

Run this command on macOS if the start script does not automatically set up everything.

```shell
xcode-select --install
```

--------------------------------

### Run cyberdrop-dl from CLI

Source: https://script-ware.gitbook.io/cyberdrop-dl/getting-started.md

Execute this command in your terminal to start the cyberdrop-dl application after a manual installation. Use the 'Edit URLs' option to add download links and then select 'download' to begin.

```shell
cyberdrop-dl
```

--------------------------------

### Install uv on Windows

Source: https://script-ware.gitbook.io/cyberdrop-dl/getting-started/cyberdrop-dl-install.md

Installs the `uv` package manager on Windows systems using PowerShell. This is a prerequisite for the recommended manual installation method.

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

--------------------------------

### Example Partial Configuration

Source: https://script-ware.gitbook.io/cyberdrop-dl/reference/config.md

A valid configuration file can specify only the settings you want to override. This example sets `dump_json` to true and `ignore_history` to true.

```yaml
dump_json: true
ignore_history: true
```

--------------------------------

### Rule34Vault Content Access Examples

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples demonstrating how to access different types of content on Rule34Vault. These include playlists, posts, and tags.

```html
/playlists/view/...
```

```html
/post/...
```

```html
/...
```

--------------------------------

### Install Cyberdrop-DL using uv

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/getting-started/cyberdrop-dl-install

After installing uv, use this command to install the cyberdrop-dl-patched package.

```shell
uv tool install cyberdrop-dl-patched

```

--------------------------------

### Example Folder Structures with max_thread_folder_depth

Source: https://script-ware.gitbook.io/cyberdrop-dl/reference/config/general.md

Illustrates the resulting folder structures based on different `max_thread_folder_depth` settings. These examples show the impact of `null`, `0`, and `1` on nested thread organization.

```shell
└── thread_01
    ├── thread_02
    ├── thread_03
    │   ├── thread_09
    │   ├── thread_10
    │   └── thread_11
    ├── thread_04
    ├── thread_05
    ├── thread_06
    ├── thread_07
    │   └── thread_12
    └── thread_08
```

```shell
├── thread_01
├── thread_02
├── thread_03
├── thread_09
├── thread_10
├── thread_11
├── thread_04
├── thread_05
├── thread_06
├── thread_07
├── thread_12
└── thread_08
```

```shell
└── thread_01
    ├── thread_02
    ├── thread_03
    ├── thread_09
    ├── thread_10
    ├── thread_11
    ├── thread_04
    ├── thread_05
    ├── thread_06
    ├── thread_07
    ├── thread_12
    └── thread_08
```

--------------------------------

### Install Cyberdrop-DL with Apprise support

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/notifications

Install Cyberdrop-DL with the Apprise extra to enable notifications to various services.

```shell
uv tool install cyberdrop-dl-patched[apprise]
```

--------------------------------

### Install pipx Package Manager

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/getting-started/cyberdrop-dl-install

Install pipx if you do not already have it, as it is recommended for managing Python applications.

```shell
pip install pipx

```

--------------------------------

### Install Cyberdrop-dl and Dependencies on Termux

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/getting-started/cyberdrop-dl-on-android

Run these commands in Termux to set up storage access, upgrade packages, install dependencies like Rust and Python, and install Cyberdrop-dl. It also configures an alias for easier execution.

```shell
# Get storage access permission
termux-setup-storage

# Install dependencies
pkg upgrade -y
pkg install rust which micro libjpeg-turbo python uv -y

# Install CDL and setup appdata folder
uv tool install cyberdrop-dl-patched
uv tool update-shell
mkdir /sdcard/cyberdrop-dl
echo 'alias cyberdrop-dl="cyberdrop-dl --portrait --appdata-folder /sdcard/cyberdrop-dl"' >> ~/.bashrc
source ~/.bashrc
```

--------------------------------

### Pkmncards.com Example Paths

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of specific paths for downloading cards, series, and sets from Pkmncards.com. These paths are used in conjunction with the site pattern.

```plaintext
/card/...
/series/...
/set/...
```

--------------------------------

### Download Content Immediately

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/cli-arguments

Skips the user interface and starts the download process immediately. This is useful for automated scripts.

```shell
cyberdrop-dl --download URL
```

--------------------------------

### Configure JDownloader Autostart

Source: https://script-ware.gitbook.io/cyberdrop-dl/reference/config/jdownloader.md

Set `autostart` to `true` to have JDownloader start downloads immediately. If `false`, downloads are added to the LinkGrabber queue.

```yaml
jdownloader:
  autostart: false
```

--------------------------------

### Install pipx

Source: https://script-ware.gitbook.io/cyberdrop-dl/getting-started/cyberdrop-dl-install.md

Installs `pipx`, a tool for installing and running Python applications in isolated environments. This is a prerequisite for installing `cyberdrop-dl` using `pipx`.

```shell
pip install pipx
```

--------------------------------

### Install uv Package Manager on Windows

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/getting-started/cyberdrop-dl-install

Use this PowerShell command to install the uv package manager on Windows systems.

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

```

--------------------------------

### Install Cyberdrop-DL using pipx

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/getting-started/cyberdrop-dl-install

Install the cyberdrop-dl-patched package using pipx after installing pipx itself.

```shell
pipx install cyberdrop-dl-patched

```

--------------------------------

### Install Cyberdrop-dl on Termux

Source: https://script-ware.gitbook.io/cyberdrop-dl/getting-started/cyberdrop-dl-on-android.md

Run these commands in Termux to install Cyberdrop-dl and its dependencies. Ensure you have sufficient storage space as Rust compilation can be intensive.

```shell
#!/bin/sh
termux-setup-storage
pkg upgrade -y
pkg install rust micro ffmpeg python uv -y

# Making sure maturin knows we are building ON Android, not FOR Android
ANDROID_API_LEVEL=24
export ANDROID_API_LEVEL

uv tool install --upgrade --force cyberdrop-dl-patched
uv tool update-shell
```

--------------------------------

### Example: Maximum Thread Folder Depth (1)

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/configuration-options/settings/download_options

Demonstrates the folder structure when `maximum_thread_folder_depth` is limited to `1`, creating a single level of subfolders.

```shell
└── thread_01
    ├── thread_02
    ├── thread_03
    ├── thread_09
    ├── thread_10
    ├── thread_11
    ├── thread_04
    ├── thread_05
    ├── thread_06
    ├── thread_07
    ├── thread_12
    └── thread_08
```

--------------------------------

### Install uv Package Manager on macOS/Linux

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/getting-started/cyberdrop-dl-install

Use this command to install the uv package manager on macOS or Linux systems.

```shell
curl -LsSf https://astral.sh/uv/install.sh | sh

```

--------------------------------

### Native OS Notification Syntaxes

Source: https://script-ware.gitbook.io/cyberdrop-dl/reference/config/notifications.md

Examples of Apprise URL syntaxes for native OS notifications on Linux, macOS, and Windows.

```text
dbus://
qt://
qt://
glib://
kde://
```

```text
gnome://
```

```text
macosx://
```

```text
windows://
```

--------------------------------

### Example: Maximum Thread Folder Depth (None)

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/configuration-options/settings/download_options

Illustrates the folder structure when `maximum_thread_folder_depth` is set to `None`, allowing unlimited nesting.

```shell
└── thread_01
    ├── thread_02
    ├── thread_03
    │   ├── thread_09
    │   ├── thread_10
    │   └── thread_11
    ├── thread_04
    ├── thread_05
    ├── thread_06
    ├── thread_07
    │   └── thread_12
    └── thread_08
```

--------------------------------

### Uninstall Old and Install New Package

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/migration-to-cyberdrop-dl-patched

Use these pip commands to remove the old version and install the patched version of the package.

```shell
pip uninstall -y cyberdrop-dl
pip install cyberdrop-dl-patched
```

--------------------------------

### Run Cyberdrop-DL CLI

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/getting-started

Execute this command in your terminal to run the Cyberdrop-DL application after a manual installation.

```shell
cyberdrop-dl-patched
```

--------------------------------

### Example Download Folder Structure

Source: https://script-ware.gitbook.io/cyberdrop-dl/reference/config/sorting.md

Illustrates the resulting folder structure after downloading grouped URLs. Files are organized into 'Loose Files' and named group folders.

```shell
└── downloads
    ├── Group 1
    │   ├── file2.jpg
    │   └── file3.jpg
    ├── Group 2
    │   ├── file5.jpg
    │   └── file6.jpg
    └── Loose Files
        ├── file1.jpg
        ├── file4.jpg
        └── file7.jpg
```

--------------------------------

### Install Cyberdrop-DL using pip

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/getting-started/cyberdrop-dl-install

Install the cyberdrop-dl-patched package directly using pip. This method is discouraged due to potential dependency conflicts.

```shell
pip install cyberdrop-dl-patched

```

--------------------------------

### Imx.to URL Structures

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of how to form URLs for galleries and images on imx.to. Use these patterns to access specific content.

```text
/g/<gallery_id>
```

```text
/i/...
```

```text
/u/i/...
```

```text
/t/...
```

```text
/u/t/
```

--------------------------------

### Example: Maximum Thread Folder Depth (0)

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/configuration-options/settings/download_options

Shows the flat file structure created when `maximum_thread_folder_depth` is set to `0`, disabling subfolder creation.

```shell
├── thread_01
├── thread_02
├── thread_03
├── thread_09
├── thread_10
├── thread_11
├── thread_04
├── thread_05
├── thread_06
├── thread_07
├── thread_12
└── thread_08
```

--------------------------------

### GoFile Password Protected Download Example

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

To download password-protected folders from GoFile, append the 'password' query parameter to the URL.

```plaintext
https://gofile.io/d/ABC654?password=1234
```

--------------------------------

### Install Cyberdrop-DL v6.5.0 for V4 Upgrade

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/upgrade

Use this command to install version 6.5.0, which is the last version supporting V4 imports, as a prerequisite for upgrading to the latest version.

```shell
pip install cyberdrop-dl-patched==6.5.0
```

--------------------------------

### ok.ru URL Formats

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of how to format URLs for ok.ru (Odnoklassniki) to download channel or video content.

```plaintext
/profile/<username>/c<channel_id>
```

```plaintext
/video/c<channel_id>
```

```plaintext
/video/<video_id>
```

--------------------------------

### PostImg URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL patterns for PostImg albums and direct image links.

```text
/gallery/<album_id>/...
```

```text
i.postimg.cc/<image_id>/...
```

```text
/<image_id>/...
```

--------------------------------

### Ask a Question via HTTP GET

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev

Use this method to query the documentation index for specific information. The 'ask' parameter is mandatory for your question, and the 'goal' parameter is optional for specifying a broader objective.

```http
GET https://script-ware.gitbook.io/cyberdrop-dl/readme.md?ask=<question>&goal=<end_goal>
```

--------------------------------

### AnySex Content Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL patterns for accessing albums, search results, and videos on AnySex.com.

```text
Album:
- /photos/<album_id>/...
Search:
- /search/...
Video:
- /video/<video_id>/...
```

--------------------------------

### aShemaleTube URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL patterns for different content types on aShemaleTube. Use these patterns to specify which content to download.

```text
/creators/...
```

```text
/model/...
```

```text
/pornstars/...
```

```text
/playlists/...
```

```text
/profiles/...
```

```text
/videos/...
```

--------------------------------

### Rule34Vault URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL patterns for accessing content on Rule34Vault. Use these patterns to specify the type of content you want to download.

```regex
rule34vault.*
```

--------------------------------

### ThotHub URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL patterns for accessing albums and videos on ThotHub. Ensure the pattern matches the content you intend to download.

```html
<code>/albums/&lt;album_id&gt;/&lt;album_name&gt;</code>
```

```html
<code>/videos/...</code>
```

--------------------------------

### Configure Custom Command Line Arguments

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/getting-started/cyberdrop-dl-install

Modify the start script to pass custom arguments to Cyberdrop-DL by setting the COMMANDLINE_ARGS variable. Ensure values are enclosed in double quotes.

```shell
set "COMMANDLINE_ARGS="

```

--------------------------------

### XXXBunker URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

These are examples of URL patterns for XXXBunker. They cover categories, search, user favorites, and individual videos.

```plaintext
/categories/<category>
```

```plaintext
/search/<video_id>
```

```plaintext
/<username>/favoritevideos
```

```plaintext
/<video_id>
```

--------------------------------

### Masahub Search and Video URL Formats

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of how to construct search queries and video URLs for Masahub. Use '?s=<query>' for searches and '/title' for videos.

```text
?s=<query>
```

```text
/title
```

--------------------------------

### PornHub URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL patterns for different content types on PornHub. Use these to specify which content to download.

```text
/album/...
```

```text
/channel/...
```

```text
/gif/...
```

```text
/photo/...
```

```text
/playlist/...
```

```text
/model/...
```

```text
/pornstar/...
```

```text
/user/...
```

```text
/embed/<video_id>
```

```text
/view_video.php?viewkey=<video_id>
```

--------------------------------

### DirtyShip URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL patterns for different content types on DirtyShip. Use these to specify what to download.

```text
/category/...
```

```text
/gallery/...
```

```text
/gallery/.../...
```

```text
/tag/...
```

```text
/<video_name>
```

--------------------------------

### Group URLs for Download

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/configuration-options/settings/sorting

Example of how to define groups for URLs in a download list. URLs between group delimiters will be downloaded into a single folder named after the group.

```plaintext
https://example.com/file1.jpg
=== Group 1
https://example.com/file2.jpg
https://example.com/file3.jpg
===
https://example.com/file4.jpg
--- Group 2
https://example.com/file5.jpg
https://example.com/file6.jpg
===
https://example.com/file7.jpg
```

--------------------------------

### Imgur URL Formats

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of how to format URLs for different Imgur content types. Use these patterns to ensure correct parsing of albums, direct links, galleries, and images.

```text
/a/<album_id>
```

```text
https://i.imgur.com/<image_id>.<ext>
```

```text
/gallery/<slug>-<album_id>
```

```text
/<image_id>
```

--------------------------------

### ImagePond URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL patterns for accessing different content types on ImagePond. These include albums, categories, direct image links, user profiles, and videos.

```plaintext
/a/<id>
```

```plaintext
/a/<name>.<id>
```

```plaintext
/album/<id>
```

```plaintext
/album/<name>.<id>
```

```plaintext
/category/<name>
```

```plaintext
/image/<id>
```

```plaintext
/image/<name>.<id>
```

```plaintext
/img/<id>
```

```plaintext
/img/<name>.<id>
```

```plaintext
/<user_name>
```

```plaintext
/video/<id>
```

```plaintext
/video/<name>.<id>
```

```plaintext
/videos/<id>
```

```plaintext
/videos/<name>.<id>
```

--------------------------------

### Configure JDownloader Whitelist

Source: https://script-ware.gitbook.io/cyberdrop-dl/reference/config/jdownloader.md

Provide a list of domain names in `whitelist`. Unsupported URLs are only sent to JDownloader if their host is on this list. An empty list sends any unsupported URL.

```yaml
jdownloader:
  whitelist: []
```

--------------------------------

### Specify Custom Database and Config Files

Source: https://script-ware.gitbook.io/cyberdrop-dl/getting-started/cyberdrop-dl-on-android.md

Use these commands to create custom locations for the database and configuration files, preventing data loss on uninstallation. This is useful for persistent storage on external media.

```shell
mkdir /sdcard/cyberdrop-dl
touch /sdcard/cyberdrop-dl/cyberdrop.db
touch /sdcard/cyberdrop-dl/config.yaml
cyberdrop-dl --database-file /sdcard/cyberdrop-dl/cyberdrop.db --config-file /sdcard/cyberdrop-dl/config.yaml
```

--------------------------------

### Hitomi.la Search URL

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Example of a search URL for Hitomi.la.

```text
/search.html?"<query>"
```

--------------------------------

### Enable JDownloader Integration

Source: https://script-ware.gitbook.io/cyberdrop-dl/reference/config/jdownloader.md

Set `enabled` to `true` to send unsupported URLs to JDownloader. If `false`, all other JDownloader settings are ignored.

```yaml
jdownloader:
  enabled: false
```

--------------------------------

### Hitomi.la Gallery URLs

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of gallery URLs for Hitomi.la.

```text
/anime/...
```

```text
/cg/...
```

```text
/doujinshi/...
```

```text
/galleries/...
```

```text
/gamecg/...
```

```text
/imageset/...
```

```text
/manga/...
```

```text
/reader/...
```

--------------------------------

### Hitomi.la Collection URLs

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of collection URLs for Hitomi.la.

```text
/artist/...
```

```text
/character/...
```

```text
/group/...
```

```text
/series/...
```

```text
/tag/...
```

```text
/type/...
```

--------------------------------

### Create a New Configuration File

Source: https://script-ware.gitbook.io/cyberdrop-dl/reference/config.md

Manually create a configuration file with all default settings using the 'Edit config' option or by running the command `cyberdrop-dl config new`.

```bash
cyberdrop-dl config new
```

--------------------------------

### Show Supported Sites

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/cli-arguments

Lists all the websites that cyberdrop-dl supports and then exits. This is helpful for checking compatibility.

```shell
cyberdrop-dl --show-supported-sites
```

--------------------------------

### TNAFlix URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL patterns for TNAFlix, covering channels, profiles, search, and videos.

```text
/channel/...
```

```text
/profile/...
```

```text
/search?what=<query>
```

```text
/<category>/<title>/video<video_id>
```

--------------------------------

### GirlsReleased URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL patterns for GirlsReleased.com, including models, sets, and site-specific URLs.

```text
/model/<model_id>/<model_name>
```

```text
/set/<set_id>
```

```text
/site/<site>
```

--------------------------------

### Erome.fan URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL patterns for accessing albums, profiles, and search results on Erome.fan.

```plaintext
/a/<album_id>
```

```plaintext
/a/category/<name>
```

```plaintext
/search/<query>
```

--------------------------------

### Show Help Message

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/cli-arguments

Displays the help message and exits. Use this to see all available options.

```shell
cyberdrop-dl --help
```

--------------------------------

### Chevereto URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL patterns for Chevereto albums, categories, images, profiles, and videos.

```plaintext
Album:
- /a/<id>
- /a/<name>.<id>
- /album/<id>
- /album/<name>.<id>
Category:
- /category/<name>
Direct Links
Image:
- /image/<id>
- /image/<name>.<id>
- /img/<id>
- /img/<name>.<id>
Profile:
- /<user_name>
Video:
- /video/<id>
- /video/<name>.<id>
- /videos/<id>
- /videos/<name>.<id>
```

--------------------------------

### Configure JDownloader Credentials

Source: https://script-ware.gitbook.io/cyberdrop-dl/reference/config/authentication.md

Enter your JDownloader 2 MyJDownloader device name, password, and username to integrate with the service. These are the same credentials used within the JDownloader 2 application settings.

```yaml
auth:
  jdownloader:
    device: <my_device_name>
    password: <my_password>
    username: <my_username>
```

--------------------------------

### Set UI Mode to Simple

Source: https://script-ware.gitbook.io/cyberdrop-dl/reference/config/ui-options.md

Configures the UI to show a spinner and a simplified progress bar. Offers a balance between detail and simplicity.

```yaml
ui:
  mode: simple
```

--------------------------------

### Configure Input Folder for Sorting

Source: https://script-ware.gitbook.io/cyberdrop-dl/reference/config/sorting.md

Set the input folder for sorting files. A null value defaults to the download folder. Subfolders are scanned recursively.

```yaml
sort:
  input_folder: null
```

--------------------------------

### Set UI Mode to Fullscreen

Source: https://script-ware.gitbook.io/cyberdrop-dl/reference/config/ui-options.md

Configures the UI to display the full interface. This is the default mode.

```yaml
ui:
  mode: fullscreen
```

--------------------------------

### E621 URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL patterns for E621. Use these to specify pools, individual posts, or search by tags.

```text
/pools/...
```

```text
/posts/...
```

```text
/posts?tags=...
```

--------------------------------

### Specify 4chan Thread URL

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

To download from a specific 4chan thread, use the thread identifier after a slash. For example, `4chan.org/thread`.

```text
/thread
```

--------------------------------

### RealBooru File and Tag Parameters

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Use the `?id=` parameter to specify a file and `?tags=` to specify tags for RealBooru.

```markdown
File:
- `?id=...`
Tags:
- `?tags=...`
```

--------------------------------

### SpankBang URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL patterns for SpankBang playlists and videos. Use these patterns to specify the content you want to download.

```text
/playlist/<playlist-id>
```

```text
/embed/<video_id>
```

```text
/play/<video_id>
```

```text
/playlist/<playlist-id>-<video_id>
```

```text
/video/<video_id>
```

--------------------------------

### Configure Output Folder for Sorting

Source: https://script-ware.gitbook.io/cyberdrop-dl/reference/config/sorting.md

Specify the directory where sorted downloads will be stored. Avoid setting this to the same path as the input folder to prevent issues.

```yaml
sort:
  output_folder: downloads/cyberdrop-dl sorted
```

--------------------------------

### Motherless URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL patterns for Motherless.com, including group, image, and user links. Note that galleries are not supported.

```regex
/g/<group_name>
```

```regex
/gi/<image>
```

```regex
/gv/<video>
```

```regex
/...
```

```regex
/f/...
```

```regex
/u/...
```

```regex
pending
```

--------------------------------

### Specify 4chan Board URL

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

To download from a specific 4chan board, use the board identifier after a slash. For example, `4chan.org/<board>`.

```text
/<board>
```

--------------------------------

### Configure Main Log File Path

Source: https://script-ware.gitbook.io/cyberdrop-dl/reference/config/logs.md

Sets the path for the primary log file. Relative paths are resolved against the base logs folder. The extension is always forced to .log.

```yaml
logs:
  files:
    main: downloader.log
```

--------------------------------

### Xasiat URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL patterns for albums, images, and videos on Xasiat.com. Use these patterns to specify the content you want to download.

```text
/albums/<id>/<name>
```

```text
/get_image/...
```

```text
/videos/<id>/<name>
```

--------------------------------

### Prefer MP3 for Clyp.it Downloads

Source: https://script-ware.gitbook.io/cyberdrop-dl/reference/config/crawlers.md

Set to true to download audios from Clyp.it as .mp3 files, even if higher quality WAV versions are available. Defaults to false.

```yaml
crawlers:
  clyp_it:
    prefer_mp3: true
```

--------------------------------

### Configure GoFile API Key

Source: https://script-ware.gitbook.io/cyberdrop-dl/reference/config/authentication.md

Provide your GoFile API key to enable premium features such as faster downloads and access to frozen files. Obtain your API key from your GoFile profile page.

```yaml
auth:
  gofile:
    api_key: <my_api_key>
```

--------------------------------

### Mega.nz URL Formats

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of file and folder URL formats for Mega.nz. Downloads from Mega.nz cannot be resumed; partial downloads will be deleted and restarted.

```text
/!#<file_id>!<share_key>
```

```text
/file/<file_id>#<share_key>
```

```text
/folder/<folder_id>#<share_key>/file/<file_id>
```

```text
/F!#<folder_id>!<share_key>
```

```text
/folder/<folder_id>#<share_key>
```

```text
/folder/<folder_id>#<share_key>/folder/<subfolder_id>
```

--------------------------------

### Tranny.One URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL patterns for accessing different content types on Tranny.One, including albums, pornstars, search results, and videos.

```plaintext
/pics/album/<album_id>
```

```plaintext
/pornstar/<model_id>/<model_name>
```

```plaintext
/search/<search_query>
```

```plaintext
/view/<video_id>
```

--------------------------------

### HotLeakVip URL Patterns

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Use these patterns to specify models or videos for download from HotLeakVip. Ensure the model and video IDs are correctly inserted.

```text
/<model_id>
```

```text
/<model_id>/video/<video_id>
```

--------------------------------

### WeTransfer Link Formats

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of different link formats supported for WeTransfer. These include direct links, public links, share links, and short links.

```text
download.wetransfer.com/...
```

```text
wetransfer.com/downloads/<file_id>/<security_hash>
```

```text
wetransfer.com/downloads/<file_id>/<recipient_id>/<security_hash>
```

```text
we.tl/<short_file_id>
```

--------------------------------

### Set Minimum Video Size

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/cli-arguments

Sets the minimum required size for video files to be downloaded. Files smaller than this limit will be skipped.

```shell
cyberdrop-dl --minimum-video-size 1M URL
```

--------------------------------

### Streamtape URL Formats

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/supported-websites

Examples of URL formats for Streamtape, differentiating between player and video endpoints. Use these patterns to construct valid URLs for accessing content.

```plaintext
/e/<video_id>
```

```plaintext
/v/<video_id>
```

--------------------------------

### Specify Downloaded Sites

Source: https://script-ware.gitbook.io/cyberdrop-dl/dev/reference/cli-arguments

Limits the download to content from specific sites. This is useful when dealing with multiple sources.

```shell
cyberdrop-dl --sites example.com another.net URL
```
Tokens:
Raw