Skip to content

Command Arguments Reference

You can add these arguments AFTER the link to customize how the bot handles your download. Most arguments work with both mirror and leech commands.

How to use arguments

/command link -arg1 -arg2 value

Examples:

/mirror https://example.com/video.mp4 -n myfile.mp4 -up gdl
/leech https://example.com/file.zip -z mypassword -sp 500mb

All arguments

-n — New name

Rename the file before upload. Doesn't work with torrents.

/mirror link -n myfile.mp4

-up — Upload destination

Choose where to upload the file.

/mirror link -up rcl                   # Rclone (opens button menu)
/mirror link -up gdl                   # Google Drive (opens button menu)
/mirror link -up remote:dir            # Direct Rclone path
/mirror link -up gdrive_id             # Direct GDrive folder ID
/mirror link -up pm                    # Send to your Telegram PM
/mirror link -up @username             # Send to a Telegram chat
/mirror link -up id\|topic_id          # Send to a forum topic
/mirror link -up mrcc:remote:path      # Use your Rclone config from userset
/mirror link -up mtp:gdrive_id         # Use your token.pickle from userset
/mirror link -up tp:gdrive_id          # Use token.pickle for GDrive
/mirror link -up sa:gdrive_id          # Use service accounts for GDrive

-z — Zip

Compress files into a zip archive. Optional password.

/mirror link -z                        # Zip without password
/mirror link -z mypassword             # Zip with password

-e — Extract

Extract compressed files (zip, rar, 7z, tar, etc.).

/mirror link -e                        # Extract without password
/mirror link -e mypassword             # Extract with password

-z + -e together — Extract then Zip

/mirror link -z mypass -e mypass       # Extract first, then zip

-sp — Split size

Split large files into smaller parts. Supports mb, gb, or bytes.

/mirror link -sp 500mb
/mirror link -sp 2gb

-s — Select files (torrent)

Open a file selection menu for torrents, NZBs, or JDownloader.

/qbmirror link -s

-t — Thumbnail

Set a custom thumbnail image.

/mirror link -t https://example.com/thumb.jpg
/mirror link -t none                   # Remove thumbnail

-d — Seed (torrents)

Keep seeding after download. Format: ratio:time_minutes.

/mirror link -d 0.7:10                 # Ratio 0.7 OR 10 minutes
/mirror link -d 0.7                    # Ratio only
/mirror link -d :10                    # Time only

Download multiple links in sequence. Reply to the first link.

/mirror -i 5

-b — Bulk mode

Download many links from a text message/file. Reply to the message.

/mirror -b
/mirror -b 2:5                         # Bulk range (links 2-5)

-m — Same directory

Put all downloaded files into one folder.

/mirror -i 3 -m "My Folder"

-sv — Sample video

Create a short sample clip. Default: 60s sample with 4s parts.

/mirror link -sv                       # Default (60:4)
/mirror link -sv 30:5                  # 30s sample, 5s parts

-ss — Screenshots

Take screenshots from a video.

/mirror link -ss                       # Default 10 screenshots
/mirror link -ss 6                     # 6 screenshots

-ca — Convert audio

Convert audio to a different format.

/mirror link -ca mp3                   # All audio to mp3
/mirror link -ca mp3 + flac ogg        # Only flac/ogg to mp3

-cv — Convert video

Convert video to a different format.

/mirror link -cv mp4                   # All video to mp4
/mirror link -cv mkv - webm flv        # All except webm/flv to mkv

-doc — Leech as document

Send files as documents (no preview).

/leech link -doc

-med — Leech as media

Send files as media (with preview).

/leech link -med

-f — Force start

Skip the queue and start immediately.

/mirror link -f                        # Force both download and upload
/mirror link -fd                       # Force download only
/mirror link -fu                       # Force upload only

-ff — FFmpeg commands

Run custom FFmpeg processing on files.

/mirror link -ff ["-i mltb.mkv -c copy -c:s srt mltb.mkv"]

-meta — Metadata

Add metadata to media files.

/mirror link -meta title=MyMovie|artist=Singer

-ns — Name swap

Replace text in filenames. Format: old/new/s (s = case-sensitive).

/mirror link -ns script/code
/mirror link -ns \[mltb\]/mltb

-rcf — Rclone flags

Pass extra flags to Rclone during upload.

/mirror link -rcf --buffer-size:8M|--drive-starred-only

-hl — Hybrid leech

Leech using both bot and user, based on file size.

/leech link -hl

-bt — Leech by bot

Leech using the bot session only.

/leech link -bt

-ut — Leech by user

Leech using the user session only.

/leech link -ut

-tl — Thumbnail layout

Set thumbnail grid layout. Format: widthxheight.

/leech link -tl 3x3

-opt — yt-dlp options (JSON)

Pass custom yt-dlp options in JSON format. Only for ytdl commands.

/ytdl link -opt {"format":"best"}

-au — Auth username

Username for direct link authorization.

/mirror link -au myuser

-ap — Auth password

Password for direct link authorization.

/mirror link -ap mypass

-h — Custom headers

Add custom HTTP headers for direct link downloads.

/mirror link -h "key: value" "key2: value2"

-j — Join files

Join split files (001, 002, etc.) before processing.

/mirror link -j -m "folder"

Argument compatibility

ArgMirrorLeechYTDLClone
-nYesYesYesNo
-upYesYesYesYes
-zYesYesYesNo
-eYesYesNoNo
-spYesYesYesNo
-sYesYesYes (quality)No
-tYesYesYesNo
-dYesYesNoNo
-iYesYesYesYes
-bYesYesYesYes
-mYesYesYesNo
-svYesYesYesNo
-ssYesYesYesNo
-caYesYesYesNo
-cvYesYesYesNo
-docYesYesYesNo
-medYesYesYesNo
-fYesYesYesNo
-fdYesYesYesNo
-fuYesYesYesNo
-ffYesYesYesNo
-metaYesYesYesNo
-nsYesYesYesNo
-rcfYesYesYesYes
-hlYesYesYesNo
-btYesYesYesNo
-utYesYesYesNo
-tlYesYesYesNo
-optNoNoYesNo
-auYesYesNoNo
-apYesYesNoNo
-hYesYesNoNo
-jYesYesNoNo