Skip to content

Bulk asynchronous downloader for multiple file hosts

50.1 KB
Raw Blame

icon: rectangle-terminal description: Here's the available CLI Arguments layout: title: visible: true description: visible: true tableOfContents: visible: true outline: visible: false pagination: visible: true


CLI Arguments

{% hint style="info" %} CLI inputs always take priority over config values. {% endhint %}

{% hint style="info" %} Use - instead of _ to separate words in an config option name when using it as a CLI argument:

Ex: delete_partial_files needs to be delete-partial-files when using it via the CLI {% endhint %}

All config option except authentication credentials have a CLI equivalent to override them.

For items not explained below, you can find their counterparts in the configuration options to see what they do.

CLI only arguments

These options can only be supplied via CLI argmunets. They are not included on the config file

--config-file

Type Default
Path null

Path to the config file to use for this session. The config file at the default location will be ignored. This file must have a .yml or .yaml extension

{% hint style="info" %} If provided, this file must exists already, but it can be empty {% endhint %}

--cache-file

Type Default
Path null

Path to the cache file to use for this session. The cache at the default location will be ignored. This file must have a .json extension

{% hint style="info" %} If provided, this file must exists already, but it can be empty {% endhint %}

--database-file

Type Default
Path null

Path to the database file to use for this session. The database at the default location will be ignored. This file must have a .db extension

{% hint style="info" %} If provided, this file must exists already, but it can be empty {% endhint %}

Overview

cyberdrop-dl v10.14.0
Bulk asynchronous downloader for multiple file hosts

Usage: cyberdrop-dl COMMAND [OPTIONS]

Run 'cyberdrop-dl' without arguments to start the interactive TUI

╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────╮
│ cache      Cache operations                                                                      │
│ cleanup    Perform maintenance tasks                                                             │
│ config     Config file operations                                                                │
│ database   Commands for managing the database                                                    │
│ download   Download URLs                                                                         │
│ hash       Compute and save hashes of every file in a folder (recursively)                       │
│ report     Generate and display information about the system                                     │
│ retry      Retry downloads from the database                                                     │
│ show       Show a list of all supported sites                                                    │
│ --help -h  Display this message and exit.                                                        │
│ --version  Display application version.                                                          │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Parameters ─────────────────────────────────────────────────────────────────────────────────────╮
│ --input-file --input -i PATH    Text/HTML file with URL(s) to download                           │
│ --config-file --config -c PATH  YAML file to use as config                                       │
│ --cache-file PATH               JSON file to use as cache                                        │
│ --database-file --db PATH       SQLite file to use as database                                   │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

Github:      https://github.com/Cyberdrop-DL/cyberdrop-dl
Wiki (docs): https://script-ware.gitbook.io/cyberdrop-dl

────────────────────────────────────────────────────────────────────────────────────────────────────

cyberdrop-dl v10.14.0
Bulk asynchronous downloader for multiple file hosts

Usage: cyberdrop-dl download [OPTIONS] [ARGS...]

Download URLs

╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────╮
│ URLS_OR_FILES  File(s)/ URL(s) to download                                                       │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Parameters ─────────────────────────────────────────────────────────────────────────────────────╮
│ --input-file PATH                    Text/HTML file with URL(s) to download                      │
│ --input-folder PATH                  Read all '.txt' within this folder for URL(s) to download   │
│                                      (non recursive).                                            │
│                                                  All URLs within the same file will be grouped   │
│                                      in the own subfolder (the filename) within the downloads    │
│                                      folder                                                      │
│ --input -i PATH                      File/folder with URL(s) to download (non recursive)         │
│ --config-file --config -c PATH       YAML file to use as config                                  │
│ --cache-file PATH                    JSON file to use as cache                                   │
│ --database-file --db PATH            SQLite file to use as database                              │
│ --cookies PATH                       File/folder to import cookies from (.txt Netscape files)    │
│ --deep-scrape --no-deep-scrape       Make additional requests while scraping (slower)            │
│                                      [default: False]                                            │
│ --delete-empty-folders               Delete empty files and folders after a run                  │
│   --no-delete-empty-folders          [default: True]                                             │
│ --delete-partial-files               Delete partial files after a run                            │
│   --no-delete-partial-files          [default: False]                                            │
│ --download-folder --output -o -d     Base output path for all downloads                          │
│   PATH                               [default: downloads/cyberdrop-dl]                           │
│ --dump-json -j --no-dump-json        Save details about each file (both skipped and downloaded)  │
│                                      to a .jsonl file                                            │
│                                      [default: False]                                            │
│ --ignore-history                     Download files even if the already are marked as downloaded │
│   --no-ignore-history                on the database                                             │
│                                      [default: False]                                            │
│ --ignore-hashes --no-ignore-hashes   Download files even if their hash matches a file downloaded │
│                                      on the database                                             │
│                                      [default: False]                                            │
│ --max-file-name-length INT           Max number of characters a filename should have. Filenames  │
│                                      longer that this will be truncated                          │
│                                      [default: 95]                                               │
│ --max-folder-name-length INT         Max number of characters a folder should have. Filenames    │
│                                      longer that this will be truncated                          │
│                                      [default: 60]                                               │
│ --max-thread-depth INT               Restricts how many levels of nested threads are scraped on  │
│                                      a forum                                                     │
│                                      [default: 0]                                                │
│ --max-thread-folder-depth INT        Max number of nested folders CDL will create when           │
│                                      maximum_thread_depth is greater that 0                      │
│ --min-free-space BYTESIZE            Minimum free space require to start new downloads           │
│                                      [default: 5368709120]                                       │
│ --mtime --no-mtime                   Use original upload date as modification date for           │
│                                      downloaded file                                             │
│                                      [default: True]                                             │
│ --restrict-path                      [choices: unix, windows, no_emoji, ascii]                   │
│   --restrict-filenames CHOICE...     [default: ()]                                               │
│ --update-check -U --no-update-check  Check for updates at the end of the session                 │
│                                      [default: True]                                             │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Crawlers ───────────────────────────────────────────────────────────────────────────────────────╮
│ --crawlers.disabled STR...           Name of crawlers to disable for the current run             │
│                                      [default: {}]                                               │
│ --crawlers.bandcamp.formats          Format to choose for downloads (if available), ordered by   │
│   CHOICE...                          preference                                                  │
│                                      [choices: mp3-320, mp3, aac-hi, wav, flac, vorbis, aiff,    │
│                                      alas]                                                       │
│                                      [default: ('mp3-320', 'mp3', 'aac-hi', 'wav', 'flac',       │
│                                      'vorbis', 'aiff', 'alas')]                                  │
│ --crawlers.bluesky.external          Parse and download embeds from third-party sites            │
│   --crawlers.bluesky.no-external     [default: True]                                             │
│ --crawlers.bluesky.threads           Downloads all posts in a thread (All direct replies from OP │
│   --crawlers.bluesky.no-threads      to their own post)                                          │
│                                      [default: True]                                             │
│ --crawlers.bluesky.content-urls      Parse and try to download any URL found inside the text of  │
│   --crawlers.bluesky                 a post                                                      │
│   .no-content-urls                   [default: True]                                             │
│ --crawlers.bluesky.reposts           Download media from reposts in the user's timeline          │
│   --crawlers.bluesky.no-reposts      [default: False]                                            │
│ --crawlers.clonr.use-source          Ignore files in clone and process the original Mega.nz URL  │
│   --crawlers.clonr.no-use-source     [default: False]                                            │
│ --crawlers.clonr.zip                 Download entire clone as a single ZIP file                  │
│   --crawlers.clonr.no-zip            [default: False]                                            │
│ --crawlers.clypit.prefer-mp3         Download audios as .mp3 files even if WAV (high quality)    │
│   --crawlers.clypit.no-prefer-mp3    versions are available                                      │
│                                      [default: False]                                            │
│ --crawlers.generic.wordpress-media   [default: ()]                                               │
│   URL...                                                                                         │
│ --crawlers.generic.wordpress-html    [default: ()]                                               │
│   URL...                                                                                         │
│ --crawlers.generic.discourse URL...  [default: ()]                                               │
│ --crawlers.generic.chevereto URL...  [default: ()]                                               │
│ --crawlers.generic.kvs URL...        [default: ()]                                               │
│ --crawlers.generic.video URL...      [default: ()]                                               │
│ --crawlers.generic.peertube URL...   [default: ()]                                               │
│ --crawlers.google-drive              Default format for documents (can be overridden per URL     │
│   .default-formats.docs CHOICE       with the 'format' query param)                              │
│                                      [choices: docx, odt, rtf, txt, epub, pdf, md, zip]          │
│                                      [default: docx]                                             │
│ --crawlers.google-drive              Default format for spreedsheets (can be overridden per URL  │
│   .default-formats.sheets CHOICE     with the 'format' query param)                              │
│                                      [choices: xslx, ods, html, csv, tsv]                        │
│                                      [default: xslx]                                             │
│ --crawlers.google-drive              Default format for presentations (can be overridden per URL │
│   .default-formats.slides CHOICE     with the 'format' query param)                              │
│                                      [choices: pptx, odp]                                        │
│                                      [default: pptx]                                             │
│ --crawlers.octave-music.quality      Quality of audio file to download (lossless are .flac       │
│   CHOICE                             files)                                                      │
│                                      [choices: lossless, mp3-320]                                │
│                                      [default: mp3-320]                                          │
│ --crawlers.octave-music              Format to generate audio file                               │
│   .filename-format STR               [default: {artist} - {title}{ext}]                          │
│ --crawlers.one-pace.prefer-dub       Download episodes with english audio tracks instead of      │
│   --crawlers.one-pace.no-prefer-dub  japanese (if available)                                     │
│                                      [default: False]                                            │
│ --crawlers.only-haven.file           Download the main file in a post (if any)                   │
│   --crawlers.only-haven.no-file      [default: True]                                             │
│ --crawlers.only-haven.attachments    Download all attachments in a post (may or may not include  │
│   --crawlers.only-haven              `file`)                                                     │
│   .no-attachments                    [default: True]                                             │
│ --crawlers.only-haven.content-urls   Download any URL found inside the description (text) of a   │
│   --crawlers.only-haven              post                                                        │
│   .no-content-urls                   [default: True]                                             │
│ --crawlers.only-haven.expand-posts   Make an additional API request for each post to get         │
│   --crawlers.only-haven              original filenames and the content/text (slower)            │
│   .no-expand-posts                   [default: False]                                            │
│ --crawlers.only-haven.embed          Download the embedded file from third party sites (if       │
│   --crawlers.only-haven.no-embed     any)(mega.nz, pcloud, dropbox, etc..)                       │
│                                      [default: True]                                             │
│ --crawlers.patreon.content-urls      Download any URL found inside the description (text) of a   │
│   --crawlers.patreon                 post                                                        │
│   .no-content-urls                   [default: True]                                             │
│ --crawlers.pawchive.file             Download the main file in a post (if any)                   │
│   --crawlers.pawchive.no-file        [default: True]                                             │
│ --crawlers.pawchive.attachments      Download all attachments in a post (may or may not include  │
│   --crawlers.pawchive                `file`)                                                     │
│   .no-attachments                    [default: True]                                             │
│ --crawlers.pawchive.content-urls     Download any URL found inside the description (text) of a   │
│   --crawlers.pawchive                post                                                        │
│   .no-content-urls                   [default: True]                                             │
│ --crawlers.pawchive.expand-posts     Make an additional API request for each post to get         │
│   --crawlers.pawchive                original filenames and the content/text (slower)            │
│   .no-expand-posts                   [default: False]                                            │
│ --crawlers.pawchive.embed            Download the embedded file from third party sites (if       │
│   --crawlers.pawchive.no-embed       any)(mega.nz, pcloud, dropbox, etc..)                       │
│                                      [default: True]                                             │
│ --crawlers.pornhub.profile-paths     Subpaths to scrape when an input URL is a profile's         │
│   STR...                             homepage                                                    │
│                                      [default: ('photos/public', 'gifs/public', 'videos',        │
│                                      'videos/upload')]                                           │
│ --crawlers.reddit.api CHOICE         [choices: arctic_shift]                                     │
│                                      [default: arctic_shift]                                     │
│ --crawlers.reddit.content-urls       Download any URL found inside the description (text) of a   │
│   --crawlers.reddit.no-content-urls  post                                                        │
│                                      [default: True]                                             │
│ --crawlers.tiktok.original           Download videos in original quality (slower)                │
│   --crawlers.tiktok.no-original      [default: False]                                            │
│ --crawlers.twitter.cards             Parse and download cards in a post (embeds from third-party │
│   --crawlers.twitter.no-cards        sites)                                                      │
│                                      [default: True]                                             │
│ --crawlers.twitter.threads           Downloads all posts in a thread (All direct replies from OP │
│   --crawlers.twitter.no-threads      to their own tweet)                                         │
│                                      [default: True]                                             │
│ --crawlers.twitter.content-urls      Parse and try to download any URL found inside the text of  │
│   --crawlers.twitter                 a tweet                                                     │
│   .no-content-urls                   [default: True]                                             │
│ --crawlers.twitter.articles.cover    Download the cover image of articles                        │
│   --crawlers.twitter.articles        [default: True]                                             │
│   .no-cover                                                                                      │
│ --crawlers.twitter.articles.media    Download media files in the body of articles                │
│   --crawlers.twitter.articles        [default: True]                                             │
│   .no-media                                                                                      │
│ --crawlers.twitter.retweets          Download media from retweets in the user's timeline         │
│   --crawlers.twitter.no-retweets     [default: False]                                            │
│ --crawlers.twitter.image-size        [choices: orig, 4096x4096, large, medium, small, thumb]     │
│   CHOICE                             [default: orig]                                             │
│ --crawlers.vk.wall-filter CHOICE     Which posts to download while scraping an user's wall       │
│                                      [choices: all, others, owner]                               │
│                                      [default: all]                                              │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Downloads ──────────────────────────────────────────────────────────────────────────────────────╮
│ --downloads INT                     Max number of files to download simultaneously               │
│                                     [default: 15]                                                │
│ --downloads.per-domain INT          Max number of files to download simultaneously per domain    │
│                                     [default: 5]                                                 │
│ --attempts INT                      [default: 2]                                                 │
│ --delay FLOAT                       Number of seconds to wait before starting downloads          │
│                                     [default: 0.0]                                               │
│ --slow-speed BYTESIZE               Skip downloads if their speed is below this value for more   │
│                                     than 10 seconds. Set to 0 to disable                         │
│                                     [default: 0]                                                 │
│ --speed-limit BYTESIZE              Max speed rate (in bytes per second) to limit downloads      │
│                                     (combined)                                                   │
│                                     [default: 0]                                                 │
│ --back-pressure --no-back-pressure  Throttle scrape requests if there are too many downloads     │
│                                     queued for the same site                                     │
│                                     [default: True]                                              │
│ --jitter FLOAT                      Wait a random additional number of seconds in between 0 and  │
│                                     <jitter> before downloads                                    │
│                                     [default: 0]                                                 │
│ --skip-and-mark-completed           Skip all downloads and mark them as downloaded on the        │
│   --no-skip-and-mark-completed      database                                                     │
│                                     [default: False]                                             │
│ --concurrent-segments INT           Allow up to `<N>` HLS segments to be downloaded concurrently │
│                                     [default: 10]                                                │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Filters ────────────────────────────────────────────────────────────────────────────────────────╮
│ --audio --no-audio                   Download/skip audio files                                   │
│                                      [default: True]                                             │
│ --images --no-images                 Download/skip image files                                   │
│                                      [default: True]                                             │
│ --videos --no-videos                 Download/skip videos                                        │
│                                      [default: True]                                             │
│ --non-media --no-non-media           Download/skip non media files (.txt, zip, .rar, etc...)     │
│                                      [default: True]                                             │
│ --thumbnails --no-thumbnails         Download/skip thumbnails of media files (if available)      │
│                                      [default: False]                                            │
│ --image.size.min BYTESIZE                                                                        │
│ --image.size.max BYTESIZE                                                                        │
│ --video.size.min BYTESIZE                                                                        │
│ --video.size.max BYTESIZE                                                                        │
│ --audio.size.min BYTESIZE                                                                        │
│ --audio.size.max BYTESIZE                                                                        │
│ --non_media.size.min BYTESIZE                                                                    │
│ --non_media.size.max BYTESIZE                                                                    │
│ --video.duration.min TIMEDELTA                                                                   │
│ --video.duration.max TIMEDELTA                                                                   │
│ --audio.duration.min TIMEDELTA                                                                   │
│ --audio.duration.max TIMEDELTA                                                                   │
│ --before DATE                        Only download files uploaded before this date               │
│ --after DATE                         Only download files uploaded after this date                │
│ --filename-regex PATTERN[STR]        Only download files that match this regex                   │
│ --filename-regex-exclude             Do NOT download files that match this regex                 │
│   PATTERN[STR]                                                                                   │
│ --only-hosts STR...                  Only scrape/download from these domains                     │
│                                      [default: {}]                                               │
│ --skip-hosts STR...                  Skip scrape/download from these domains                     │
│                                      [default: {}]                                               │
│ --allow-files-with-no-extension      Download potentially dangerous files that have no extension │
│   --no-allow-files-with-no-extensio  [default: False]                                            │
│   n                                                                                              │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Hashing ────────────────────────────────────────────────────────────────────────────────────────╮
│ --hashing CHOICE                     [choices: off, in-place, post-download]                     │
│                                      [default: in-place]                                         │
│ --hashing.algorithms --hashes        List of hashes to compute for each download                 │
│   CHOICE...                          [choices: xxh128, md5, sha256]                              │
│                                      [default: ('xxh128', 'md5', 'sha256')]                      │
│ --hashing.dedupe.enabled --dedupe    Auto delete duplicate downloads by hash                     │
│   --dedupe.enabled --auto-dedupe     [default: True]                                             │
│   --hashing.dedupe.no-enabled                                                                    │
│   --no-dedupe --dedupe.no-enabled                                                                │
│   --no-auto-dedupe                                                                               │
│ --hashing.dedupe.use-trash-bin       Send deleted files to the trash bin                         │
│   --hashing.dedupe.no-use-trash-bin  [default: True]                                             │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Jdownloader ────────────────────────────────────────────────────────────────────────────────────╮
│ --jdownloader.enabled --jdownloader  Send unsupported URLs to Jdownloader                        │
│   --jdownloader.no-enabled           [default: False]                                            │
│   --no-jdownloader                                                                               │
│ --jdownloader.deprecated-api URL     HTTP URL of a local JDownloader instance to connect to via  │
│                                      their deprecated API (insecure, default port=3128)          │
│ --jdownloader.autostart              Immediately start downloads as soon as they are sent        │
│   --jdownloader.no-autostart         [default: False]                                            │
│ --jdownloader.download-folder PATH   Output path for Jdownloader. Defaults to                    │
│                                      `--download-folder`                                         │
│ --jdownloader.whitelist STR...       Only send unsupported URLs from these domains to            │
│                                      Jdownloader. An empty list means 'send all URLs'            │
│                                      [default: {}]                                               │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Logs ───────────────────────────────────────────────────────────────────────────────────────────╮
│ --logs.level CHOICE                  Only log messages of this level or higher to the main log   │
│                                      file                                                        │
│                                      [choices: DEBUG, INFO, WARNING, ERROR, CRITICAL]            │
│                                      [default: DEBUG]                                            │
│ --logs.console-level CHOICE          Only log messages of this level or higher to the console.   │
│                                      An empty or `None` value will use the same level as         │
│                                      `log_level`                                                 │
│                                      [choices: DEBUG, INFO, WARNING, ERROR, CRITICAL]            │
│ --logs.http-traffic --print-traffic  Log HTTP requests and responses (at INFO level)             │
│   --logs.no-http-traffic             [default: True]                                             │
│   --no-print-traffic                                                                             │
│ --logs.files.main --log-file PATH    Path of main log file                                       │
│                                      [default: downloader.log]                                   │
│ --logs.files.download-errors PATH    Save download errors to this file (MUST BE .csv)            │
│                                      [default: download_errors.csv]                              │
│ --logs.files.scrape-errors PATH      Save scrape errors to this file (MUST BE .csv)              │
│                                      [default: scrape_errors.csv]                                │
│ --logs.files.unsupported PATH        Save unsupported URLs to this file (MUST BE .csv)           │
│                                      [default: unsupported.csv]                                  │
│ --logs.files.last-forum-post PATH    Save the URL of the last scraped post from each thread to   │
│                                      this file (MUST BE .csv)                                    │
│                                      [default: last_forum_post.csv]                              │
│ --logs.files.dedupe PATH             Save every duplicate deleted by the deduper, and the file   │
│                                      it matched, to this file (MUST BE .csv)                     │
│                                      [default: dedupe.csv]                                       │
│ --logs.folder PATH                   Base folder to prepend to log files paths (if they are not  │
│                                      absolute)                                                   │
│ --logs.expire-after TIMEDELTA        Delete all log files inside `--logs.folder` if they are     │
│                                      older that this                                             │
│ --logs.rotate --logs.no-rotate       Append current datetimme to every log file on each run      │
│                                      [default: False]                                            │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ MaxChildren ────────────────────────────────────────────────────────────────────────────────────╮
│ --max-children.forum INT       Do not scrape more that this number of URLs inside a forum thread │
│                                [default: 0]                                                      │
│ --max-children.forum-post INT  Do not scrape more that this number of URLs inside an individual  │
│                                a forum post                                                      │
│                                [default: 0]                                                      │
│ --max-children.profile INT     Do not scrape more that this number of URLs in a profile          │
│                                [default: 0]                                                      │
│ --max-children.album INT       Do not scrape more that this number of URLs in a album            │
│                                [default: 0]                                                      │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Network ────────────────────────────────────────────────────────────────────────────────────────╮
│ --dump-responses                     Save text/HTML/JSON responses to disk (Flaresolverr         │
│   --no-dump-responses                responses are excluded)                                     │
│                                      [default: False]                                            │
│ --flaresolverr URL                   HTTP URL of an existing Flaresolverr instance               │
│ --flaresolverr-use-session           Create a custom session before making any request with      │
│   --no-flaresolverr-use-session      Flaresolverr                                                │
│                                      [default: True]                                             │
│ --flaresolverr-wait INT              Force Flaresolverr to wait (at least) this number of        │
│                                      seconds before returning the results, to allow dynamic      │
│                                      content to load                                             │
│                                      [default: 0]                                                │
│ --flaresolverr-concurrency INT       Number of concurrent requests to make with Flaresolverr     │
│                                      [default: 1]                                                │
│ --proxy --http-proxy URL             HTTP/HTTPS proxy                                            │
│ --rate-limit FLOAT                   Max number of requests per second (only used while          │
│                                      scraping)                                                   │
│                                      [default: 25.0]                                             │
│ --connection-timeout FLOAT           [default: 15]                                               │
│ --read-timeout FLOAT                 [default: 300]                                              │
│ --ssl-context CHOICE                 [choices: truststore, certifi, truststore+certifi]          │
│                                      [default: truststore+certifi]                               │
│ --verify --ssl --no-verify --no-ssl  [default: True]                                             │
│ --tls.min-version CHOICE             [choices: 1.2, 1.3]                                         │
│                                      [default: 1.2]                                              │
│ --ca-certs PATH...                   [default: ()]                                               │
│ --user-agent STR                     [default: Mozilla/5.0 (X11; Linux x86_64; rv:153.0)         │
│                                      Gecko/20100101 Firefox/153.0]                               │
│ --impersonate CHOICE                 Use this target as impersonation for all scrape requests    │
│                                      [choices: chrome, edge, safari, safari_ios, chrome_android, │
│                                      firefox]                                                    │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Sort ───────────────────────────────────────────────────────────────────────────────────────────╮
│ --sort.enabled --sort           Enable/Disable file sorting at the end of a run                  │
│   --sort.no-enabled --no-sort   [default: False]                                                 │
│ --sort.input-folder PATH        Base folder to scan for files. Default to the same value as      │
│                                 `--download-folder`                                              │
│ --sort.output-folder PATH       Output path to place sorted files in                             │
│                                 [default: downloads/cyberdrop-dl sorted]                         │
│ --sort.formats.audio STR        Format to generate sorted audio file                             │
│                                 [default: {sort_dir}/{base_dir}/Audio/{filename}{ext}]           │
│ --sort.formats.image STR        Format to generate sorted image file                             │
│                                 [default: {sort_dir}/{base_dir}/Images/{filename}{ext}]          │
│ --sort.formats.non-media STR    Format to generate sorted files of unknown type                  │
│                                 [default: {sort_dir}/{base_dir}/Other/{filename}{ext}]           │
│ --sort.formats.video STR        Format to generate sorted video file                             │
│                                 [default: {sort_dir}/{base_dir}/Videos/{filename}{ext}]          │
│ --sort.formats.incrementer STR  Format for separator on name collisions                          │
│                                 [default:  ({i})]                                                │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ SubFolders ─────────────────────────────────────────────────────────────────────────────────────╮
│ --subfolders.create --subfolders     Enable/disable the creation of nested sub-folders           │
│   --subfolders.no-create             [default: True]                                             │
│   --no-subfolders                                                                                │
│ --subfolders.group-loose-files       Create a subfolder named 'Loose Files' for individual files │
│   --subfolders.no-group-loose-files  not part of any album/thread                                │
│                                      [default: True]                                             │
│ --subfolders.include.album-id        [default: False]                                            │
│   --subfolders.include.no-album-id                                                               │
│ --subfolders.include.thread-id       [default: False]                                            │
│   --subfolders.include.no-thread-id                                                              │
│ --subfolders.include.domain          [default: True]                                             │
│   --subfolders.include.no-domain                                                                 │
│ --subfolders.separate-posts.format   [default: {default}]                                        │
│   STR                                                                                            │
│ --subfolders.enabled                 Create new subfolders for every post on a site              │
│   --separate-posts                   [default: False]                                            │
│   --separate-posts.enabled                                                                       │
│   --subfolders.no-enabled                                                                        │
│   --no-separate-posts                                                                            │
│   --separate-posts.no-enabled                                                                    │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ UIOptions ──────────────────────────────────────────────────────────────────────────────────────╮
│ --ui CHOICE               [choices: disabled, activity, simple, fullscreen]                      │
│                           [default: fullscreen]                                                  │
│ --portrait --no-portrait  force CDL to run with a vertical layout                                │
│                           [default: False]                                                       │
│ --refresh-rate FLOAT      [default: 10.0]                                                        │
│ --stats --no-stats        Show stats report at the end of a run                                  │
│                           [default: True]                                                        │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

Github:      https://github.com/Cyberdrop-DL/cyberdrop-dl
Wiki (docs): https://script-ware.gitbook.io/cyberdrop-dl