آرگومان‌ها

همهٔ کلمه‌ها تا آرگومان بعدی جزو نام حساب می‌شوند، پس نام می‌تواند فاصله داشته باشد: -n My File.zip. در دستورهای میرور و لیچ پسوند فایل را خودتان بنویسید. طبق متن راهنمای ربات، این آرگومان روی تورنت‌ها کار نمی‌کند.

در /ytdl و /ytdlleech پسوند را ننویسید؛ ربات پسوند فایل دانلودشده را خودش به آخر نام اضافه می‌کند. برای پلی‌لیست، این مقدار نام پوشهٔ پلی‌لیست می‌شود.

در /clone، برای کلون پیام‌های تلگرام فقط نام تسک است و در کلون Rclone نام مقصد؛ در کلون گوگل درایو نام از خود فایل یا پوشهٔ مبدأ خوانده می‌شود و این مقدار جای آن را نمی‌گیرد.

هر قاعده به شکل pattern:replace:count:flag است و قاعده‌ها با | از هم جدا می‌شوند؛ مثلاً -ns 720p:1080p|sample:. اگر replace خالی بماند، متن پیداشده حذف می‌شود. count تعداد جایگزینی است و 0 (پیش‌فرض) یعنی همهٔ موارد. flag نام یکی از فلگ‌های ماژول re پایتون است، مثل IGNORECASE یا I؛ بدون آن، جستجو به بزرگی و کوچکی حروف حساس است.

نکته: صفحهٔ Name-Swap در راهنمای داخل ربات هنوز قالب قدیمی word/replace/s را نشان می‌دهد، اما کد فعلی متن را با | و : تجزیه می‌کند. دور | فاصله نگذارید، چون فاصله هم جزو الگو حساب می‌شود؛ و خود کاراکترهای | و : را نمی‌توانید در الگو بیاورید. کاراکترهای ویژهٔ regex مثل . یا [ را با \ بنویسید.

جایگزینی فقط روی نام انجام می‌شود و پسوند دست نمی‌خورد. وقتی Name Swap فعال باشد، هر بخشی از نام که با www شروع شود هم حذف می‌شود. اگر الگو خطا داشته باشد یا نام نهایی از ۲۵۵ بایت بیشتر شود، آن فایل با نام قبلی می‌ماند.

اگر -ns ندهید، مقدار NAME_SWAP از بخش Misc Settings تنظیمات کاربری، یا در نبود آن متغیر NAME_SWAP مالک، استفاده می‌شود.

در دستورهای میرور، /ytdl و /clone مقدار -up می‌تواند gd (پوشهٔ GDRIVE_ID)، rc (مسیر RCLONE_PATH)، شناسهٔ یک پوشهٔ گوگل درایو، مسیر Rclone به شکل remote:dir/subdir یا mega (حساب Mega که در تنظیمات کاربری ثبت کرده‌اید) باشد. با gdl یا rcl، ربات با دکمه از شما می‌پرسد کدام توکن و پوشه، یا کدام کانفیگ، ریموت و مسیر. بدون -up، مقصد از DEFAULT_UPLOAD شما (دکمه‌های Swap to GDRIVE API Mode و Swap to RCLONE Mode در General Settings) یا مالک تعیین می‌شود.

اگر در UPLOAD_PATHS (تنظیمات کاربری یا متغیر مالک) نام کوتاهی تعریف شده باشد، -up name با مسیر واقعی جایگزین می‌شود. برای انتخاب توکن یا کانفیگ مشخص از پیشوندهای tp:، sa:، mtp: و mrcc: استفاده کنید.

در لیچ معنای -up فرق دارد: شناسهٔ عددی چت، @username، pm (چت خصوصی خودتان) یا برای تاپیک chat_id|topic_id. فایل‌ها ابتدا در چت اصلی لیچ (چت -ud، یا LEECH_LOG_CHAT، یا همان چتی که دستور را فرستادید) آپلود می‌شوند و سپس ربات یک نسخه در این چت کپی می‌کند.

در کلون گوگل درایو یا Rclone، مبدأ و مقصد باید از یک نوع باشند و با یک توکن یا کانفیگ باز شوند؛ وگرنه خطای You must use the same token to clone! یا You must use the same config to clone! می‌گیرید. در /uphoster این آرگومان اثری ندارد.

چت دامپ (چتی که نسخه‌ای از فایل‌ها در آن ذخیره می‌شود) را می‌توانید با نام انتخاب کنید: -ud A. نام ابتدا در Leech Dump Chats خودتان (بخش Leech Settings در /usetting) و سپس در متغیر LEECH_DUMP_CHATS مالک جستجو می‌شود؛ اگر یک نام در هر دو باشد، مال شما برنده است. شناسهٔ عددی و @username هم مستقیم پذیرفته می‌شوند. برای فرستادن به یک تاپیک، چت را به شکل chat_id|topic_id در فهرست دامپ‌ها تعریف کنید و با نامش صدا بزنید؛ این شکل مستقیم در -ud پذیرفته نمی‌شود و ربات به‌جایش دکمه‌های انتخاب را نشان می‌دهد.

در لیچ، چت انتخاب‌شده مقصد اصلی آپلود همین تسک می‌شود و جای LEECH_LOG_CHAT را می‌گیرد. اگر نامی که داده‌اید پیدا نشود، ربات دکمه‌های چت‌های دامپ تعریف‌شده را نشان می‌دهد تا یکی را انتخاب کنید؛ اگر هیچ چت دامپی تعریف نشده باشد، تسک با خطا متوقف می‌شود. ربات باید در آن چت ادمین باشد و اجازهٔ مدیریت چت و حذف پیام داشته باشد.

در /clone با لینک تلگرام، -ud چند مقصد با فاصله می‌گیرد (-ud A B -1001234567890) و مقصدهای تکراری حذف می‌شوند. بدون -ud، مقصدهای Clone Settings شما و در نبود آن‌ها LEECH_LOG_CHAT استفاده می‌شود.

قالب: -rcf --buffer-size:8M|--drive-starred-only|key:value. فلگ‌ها با | از هم جدا می‌شوند و مقدار هر فلگ بعد از : می‌آید؛ برای فلگ‌های بدون مقدار فقط نام را بنویسید. فهرست کامل در مستندات فلگ‌های Rclone آمده است.

به گفتهٔ راهنمای ربات، این فلگ‌ها جای بقیهٔ فلگ‌ها را می‌گیرند، به‌جز --exclude. اگر -rcf ندهید، مقدار RCLONE_FLAGS از تنظیمات کاربری یا متغیر مالک استفاده می‌شود.

فقط وقتی اثر دارد که Rclone در کار باشد: آپلود به مسیر Rclone، دانلود از مسیر Rclone، یا کلون بین دو مسیر Rclone.

این آرگومان در متن راهنمای ربات نیامده، اما کد میرور، /ytdl و /clone آن را می‌خواند. مقدار آن نام یک دسته است: دسته‌های فایل categories.txt مالک، دستهٔ Root (همان GDRIVE_ID)، دستهٔ Default (پوشهٔ گوگل درایو شما یا مالک) و، اگر حالت دسته‌بندی درایو (DRIVE_CATEGORY_MODE) فعال باشد، دسته‌هایی که خودتان تعریف کرده‌اید.

مقادیر ویژه: gd یعنی پوشهٔ پیش‌فرض؛ gdl یعنی انتخاب با دکمه؛ یک شناسهٔ درایو به‌صورت مستقیم؛ یا drive_id|index_url. اگر نامی پیدا نشود، ربات دکمه‌های دسته‌ها را نشان می‌دهد.

وقتی -gc بدهید، DEFAULT_UPLOAD نادیده گرفته می‌شود. در لیچ اثری ندارد. دکمهٔ Index Link در پیام پایان کار همچنان از INDEX_URL شما یا مالک ساخته می‌شود، نه از لینک ایندکس دسته.

در /gdclean، -gc نام دسته‌ای است که می‌خواهید مرور و پاک‌سازی کنید؛ آنجا به‌جای فاصله در نام دسته _ بنویسید.

این آرگومان در متن راهنمای ربات نیامده، اما دستورهای خانوادهٔ /mirror آن را می‌خوانند. بعد از دانلود و پردازش، خروجی با YouTube Data API آپلود می‌شود: یک فایل تکی به‌صورت یک ویدیو، و یک پوشه به‌صورت پلی‌لیستی تازه به نام پوشه که فایل‌های پوشه در آن آپلود می‌شوند.

توکن از فایل tokens/<user_id>.pickle خوانده می‌شود؛ یعنی همان token.pickle شخصی که در بخش گوگل درایو /usetting بارگذاری کرده‌اید. این توکن باید دسترسی‌های یوتیوب را داشته باشد؛ اسکریپت gen_scripts/gen_token_pickle مخزن این دسترسی‌ها را هم درخواست می‌کند.

توضیحات، برچسب‌ها، شناسهٔ دسته و وضعیت انتشار از YT_DESP، YT_TAGS، YT_CATEGORY_ID و YT_PRIVACY_STATUS در YT-DLP Settings یا متغیرهای مالک گرفته می‌شوند. وضعیت انتشار پیش‌فرض unlisted است.

/ytdl و /ytdlleech این آرگومان را نمی‌شناسند. بررسی‌های معمول مقصد میرور پیش از دانلود همچنان انجام می‌شود، پس باید یک مقصد آپلود معتبر (مثلاً RCLONE_PATH یا GDRIVE_ID) تنظیم شده باشد، هرچند فایل به آنجا نمی‌رود.

بدون فاصله قبل از لینک یا شناسهٔ درایو بنویسید؛ هم برای منبع دانلود و هم برای -up. وقتی USE_SERVICE_ACCOUNTS روشن است، ربات به‌طور پیش‌فرض با سرویس‌اکانت‌ها کار می‌کند و tp: آن را برای همین لینک یا پوشه به token.pickle برمی‌گرداند.

مثل tp: بدون فاصله قبل از لینک یا شناسهٔ درایو می‌آید. سرویس‌اکانت‌ها باید از قبل ساخته و در پوشهٔ accounts ربات گذاشته شده باشند و به درایو مقصد دسترسی داشته باشند.

توکن شخصی از فایل tokens/<user_id>.pickle خوانده می‌شود. اگر در General Settings دکمهٔ Swap to USER token/config را زده باشید (حالت USER)، ربات این پیشوند را خودش به لینک‌ها و شناسه‌های درایو اضافه می‌کند و دیگر لازم نیست بنویسید.

کانفیگ شخصی از فایل rclone/<user_id>.conf خوانده می‌شود. هم برای منبع (/mirror mrcc:main:dump/file.iso) و هم برای مقصد (-up mrcc:main:dump) کار می‌کند. در حالت USER (دکمهٔ Swap to USER token/config در General Settings) ربات این پیشوند را خودش اضافه می‌کند.

راهنمای ربات می‌گوید -up b:@channel یعنی لیچ با ربات. در نسخهٔ فعلی کد، این پیشوند پذیرفته و از مقدار حذف می‌شود، اما بلافاصله بعد از آن حالت ارسال دوباره از TRANSMISSION_MODE و آرگومان‌های -bt، -ut و -hl تعیین می‌شود. برای ارسال با ربات از -bt استفاده کنید.

طبق راهنما، -up u:@channel یعنی ارسال با حساب کاربری (USER_SESSION_STRING). در کد فعلی پیشوند فقط حذف می‌شود و حالت ارسال از TRANSMISSION_MODE و آرگومان‌های -bt، -ut و -hl می‌آید. برای ارسال با حساب کاربری از -ut استفاده کنید.

طبق راهنما، -up h:@channel یعنی ارسال ترکیبی (فایل‌ها بر اساس اندازه با ربات یا حساب کاربری). در کد فعلی پیشوند فقط حذف می‌شود؛ برای ارسال ترکیبی از -hl استفاده کنید یا TRANSMISSION_MODE را روی both (پیش‌فرض) بگذارید.

-z به‌تنهایی آرشیو بدون رمز می‌سازد و -z password آرشیو رمزدار. آرشیو با 7z و بدون فشرده‌سازی (-mx=0) ساخته می‌شود، پس هدفش بسته‌بندی است، نه کم کردن حجم. فشرده‌سازی آخرین مرحلهٔ پردازش پیش از آپلود است.

در لیچ، اگر حجم از اندازهٔ تکه‌ها بیشتر باشد، آرشیو مستقیماً به چند بخش (.zip.001، .zip.002 و…) تقسیم می‌شود و تقسیم جداگانهٔ فایل‌ها انجام نمی‌شود.

با -e ترکیب‌پذیر است: ربات اول استخراج و بعد فشرده‌سازی می‌کند. چون همهٔ کلمه‌های بعد از -z تا آرگومان بعدی رمز حساب می‌شوند، لینک را همیشه قبل از -z بنویسید.

-e آرشیوها را با 7z استخراج می‌کند و -e password برای آرشیوهای رمزدار است. فایل‌های آرشیو (و همهٔ تکه‌های آرشیوهای چندبخشی) بعد از استخراج موفق حذف می‌شوند و پسوندهای EXCLUDED_EXTENSIONS بعد از استخراج هم کنار گذاشته می‌شوند.

در /nzbmirror و /nzbleech استخراج را خود SABnzbd انجام می‌دهد و اگر -e ننوشته باشید، ربات خودش آن را اضافه می‌کند.

فقط وقتی کار می‌کند که خروجی دانلود یک پوشه باشد؛ به همین دلیل معمولاً همراه -m به کار می‌رود تا تکه‌هایی که با چند لینک جدا دانلود می‌شوند در یک پوشه جمع شوند. اگر یک لینک خودش پوشه‌ای از فایل‌های تکه‌شده باشد، -j به‌تنهایی کافی است.

-i 10 یعنی پیامی که روی آن ریپلای کرده‌اید و ۹ پیام بعد از آن، هرکدام یک تسک جدا. ربات برای هر پیام بعدی خودش یک دستور تازه می‌فرستد، با فاصلهٔ حدود ۷ ثانیه.

اگر تعداد بیشتر از ۲ باشد، ربات دستوری به شکل /c_xxxxxx نشان می‌دهد که با آن ادامهٔ این سری را متوقف می‌کنید. همراه -m، همهٔ لینک‌ها در یک پوشه جمع و با هم آپلود می‌شوند. اگر مالک DISABLE_MULTI را فعال کرده باشد، این آرگومان کار نمی‌کند.

روی پیام متنی یا فایل متنی‌ای که در هر خطش یک لینک است ریپلای کنید و مثلاً /mirror -b بفرستید. هر خط می‌تواند آرگومان‌های خودش را داشته باشد، مثل https://example.com/a.zip -n a.zip -up remote1:path1.

آرگومان‌هایی که کنار خود دستور می‌نویسید به همهٔ لینک‌ها اضافه می‌شوند. اگر همراه دستور -m بدهید، همهٔ لینک‌ها در یک پوشه و یک مقصد آپلود می‌شوند و دیگر نمی‌توانید برای هر خط مقصد جدا بگذارید.

برای اجرای بخشی از فهرست: -b start:end، فقط پایان با -b :end یا فقط شروع با -b start. شمارش از صفر (اولین لینک) است. اگر مالک DISABLE_BULK را فعال کرده باشد، این آرگومان غیرفعال است.

با یک لینک، فقط همان محتوا داخل پوشهٔ تازه قرار می‌گیرد: -m new folder. همراه -i یا -b، همهٔ لینک‌ها در یک پوشه جمع می‌شوند و در پایان به‌صورت یک تسک آپلود می‌شوند.

در فایل bulk می‌توانید برای هر خط پوشهٔ جدا بدهید: خط‌هایی که -m یکسان دارند با هم آپلود می‌شوند و خطی که -m ندارد تنها آپلود می‌شود.

وقتی چند لینک در یک پوشه جمع شوند، تورنت‌ها سید نمی‌شوند. در /stream آرگومانی با همین نام معنای دیگری دارد (پخش پیوستهٔ چند تکه) و ربطی به این آرگومان ندارد.

در دستورهای میرور و لیچ برای تورنت (Aria2 یا qBittorrent)، NZB و JDownloader کاربرد دارد. برای تورنت و NZB، دانلود متوقف می‌ماند و دکمه‌ای برای صفحهٔ وب انتخاب فایل نمایش داده می‌شود؛ این کار به BASE_URL نیاز دارد و اگر تنظیم نشده باشد، -s نادیده گرفته می‌شود. برای JDownloader ربات تا ۱۰ دقیقه صبر می‌کند تا فایل‌ها را در سایت MyJDownloader تنظیم کنید و Done Selecting را بزنید.

در /ytdl و /ytdlleech، -s باعث می‌شود دکمه‌های انتخاب کیفیت نمایش داده شوند، حتی اگر در گزینه‌های yt-dlp کلید format تعیین شده باشد.

برای تسکی که بدون -s شروع شده، از دستور /sel_GID که در پیام وضعیت نمایش داده می‌شود استفاده کنید.

قالب -d ratio:time است و زمان به دقیقه: -d 0.7:10 (هر دو)، -d 0.7 (فقط نسبت) یا -d :10 (فقط زمان). -d به‌تنهایی سید کردن را با تنظیمات پیش‌فرض کلاینت فعال می‌کند.

فقط برای تورنت‌ها (Aria2 یا qBittorrent) معنا دارد و برای بقیهٔ منابع نادیده گرفته می‌شود. آپلود از یک کپی با symlink انجام می‌شود تا فایل‌های اصلی برای سید باقی بمانند. اگر مالک DISABLE_SEED را فعال کرده باشد، استفاده از -d پیام خطا می‌دهد. در /stream و /broadcast، -d معنای دیگری دارد.

همراه -ap استفاده می‌شود: -au username -ap password. ربات از این دو یک هدر authorization: Basic ... می‌سازد و به Aria2 می‌دهد. فقط روی دانلودهای مستقیم Aria2 اثر دارد، نه تورنت، گوگل درایو، Rclone، Mega یا فایل تلگرام.

همراه -au به کار می‌رود و همان محدودیت‌ها را دارد: فقط دانلودهای مستقیم Aria2. برای لینک سایت‌هایی که ربات خودش لینک مستقیمشان را استخراج می‌کند و رمز می‌خواهند، رمز را با :: بعد از لینک بنویسید (https://example.com/file::my password)، نه با -ap.

قالبی که راهنمای ربات نشان می‌دهد: -h key: value key1: value1. این هدرها به دانلود Aria2 داده می‌شوند. اگر هم‌زمان -au و -ap بدهید، هدر احراز هویت هم به آن‌ها اضافه می‌شود.

لینک‌های سایت‌های میزبان فایل (مثل 1fichier یا rapidgator) پیش از دانلود به API سرویس AllDebrid فرستاده می‌شوند و لینک مستقیم حاصل دانلود می‌شود.

برای مگنت یا فایل .torrent، ربات تورنت را به AllDebrid می‌فرستد، صبر می‌کند تا آنجا کامل شود و سپس هر فایل را مستقیم از سرورهای AllDebrid دانلود می‌کند؛ یعنی Aria2 و qBittorrent اصلاً درگیر نمی‌شوند.

به متغیر ALLDEBRID_API_KEY نیاز دارد. با /jdmirror، /jdleech و دستورهای NZB کار نمی‌کند.

ربات منتظر می‌ماند تا تورنت در Seedr کامل شود و سپس فایل‌ها را با HTTP معمولی دانلود می‌کند؛ برای وقتی مفید است که تورنت روی سرور شما کند یا مسدود است. فقط با مگنت و لینک .torrent کار می‌کند.

SEEDR_EMAIL و SEEDR_PASSWORD باید در /usetting یا تنظیمات ربات ثبت شده باشند. DISABLE_SEEDR به‌طور پیش‌فرض True است؛ تا مالک آن را خاموش نکند، ربات پیام غیرفعال بودن Seedr را می‌دهد. در /qbmirror و /qbleech اثری ندارد، چون مسیر qBittorrent زودتر انتخاب می‌شود.

مقدار باید یک دیکشنری پایتون باشد، مثل {'format': 'bv*+ba/b', 'writesubtitles': True}. نام کلیدها نام گزینه‌های API هستند، نه فلگ‌های خط فرمان؛ فهرستشان در فایل YoutubeDL.py آمده است.

-opt با گزینه‌های ذخیره‌شده ادغام نمی‌شود، بلکه کاملاً جای آن‌ها را می‌گیرد. ترتیب اولویت: -opt، سپس YT_DLP_OPTIONS شما در YT-DLP Settings و در آخر متغیر YT_DLP_OPTIONS مالک. اگر مقدار یک دیکشنری معتبر نباشد، بی‌صدا نادیده گرفته می‌شود (فقط در لاگ ثبت می‌شود) و همان گزینه‌های ذخیره‌شده به کار می‌روند.

اگر کلید format بدهید، دکمه‌های کیفیت نمایش داده نمی‌شوند و همان فرمت دانلود می‌شود، مگر اینکه -s هم بدهید. خط اول راهنمای /ytdl در ربات هنوز قالب قدیمی -opt x:y|x1:y1 را نشان می‌دهد؛ کد فعلی فقط دیکشنری می‌پذیرد.

مقدار می‌تواند لینک مستقیم یک تصویر (jpg، png، webp و…)، لینک پیام تلگرامی که عکس یا سند دارد، یا none باشد.

none تامبنیل شخصی شما و تامبنیل خودکار (AUTO_THUMBNAIL) را برای این تسک کنار می‌گذارد؛ با این حال ربات ممکن است برای ویدیوها همچنان فریمی از خود ویدیو را تامبنیل کند.

بدون -t، تامبنیلی که در Thumbnail Settings بخش Leech Settings ذخیره کرده‌اید استفاده می‌شود. فقط در لیچ اثر دارد. در /blacklist، -t مدت محرومیت است و در /stream تصویر کاور؛ آن‌ها ربطی به این آرگومان ندارند.

قالب: -sp 500mb، -sp 2gb یا عدد خالص به بایت مثل -sp 4000000000. راهنمای ربات فقط mb و gb (یا بایت بدون واحد) را پشتیبانی‌شده می‌داند؛ عدد اعشاری مثل 1.5gb هم پذیرفته می‌شود.

مقدار نهایی هیچ‌وقت از سقف مجاز بیشتر نمی‌شود: 2097152000 بایت (حدود ۲ گیگابایت) وقتی ارسال فقط با ربات است، و 4194304000 بایت وقتی حالت ارسال کاربری یا ترکیبی است و حساب USER_SESSION_STRING پرمیوم است. بدون -sp، LEECH_SPLIT_SIZE از تنظیمات کاربری یا متغیر مالک استفاده می‌شود.

ویدیوهایی که به‌صورت رسانه فرستاده می‌شوند با FFmpeg به چند ویدیوی قابل پخش تقسیم می‌شوند و بقیهٔ فایل‌ها به تکه‌های باینری. با EQUAL_SPLITS تکه‌ها هم‌اندازه می‌شوند.

تنظیم AS_DOCUMENT (دکمه‌های Send As Document و Send As Media در Leech Settings) را فقط برای همین تسک کنار می‌گذارد. اگر هم -doc و هم -med بدهید، -doc برنده است. ویدیوهایی که سند فرستاده می‌شوند، هنگام تکه‌کردن به تکه‌های باینری تقسیم می‌شوند، نه ویدیوهای قابل پخش.

جای AS_DOCUMENT را برای همین تسک می‌گیرد. فایل‌هایی که ویدیو، صدا یا عکس نیستند همچنان سند فرستاده می‌شوند.

قالب widthxheight است؛ -tl 3x3 یعنی ۹ فریم در سه ردیف و سه ستون و -tl 2x2 یعنی ۴ فریم. فقط برای ویدیوهایی اعمال می‌شود که به‌صورت رسانه فرستاده می‌شوند و تامبنیل دیگری ندارند؛ تامبنیل شخصی، -t و تامبنیل خودکار (AUTO_THUMBNAIL) بر آن مقدم‌اند. بدون -tl، مقدار THUMBNAIL_LAYOUT از تنظیمات کاربری یا متغیر مالک استفاده می‌شود.

حالت ارسال (TRANSMISSION_MODE، پیش‌فرض both) را برای این تسک روی both می‌گذارد. به USER_SESSION_STRING نیاز دارد؛ اگر حساب کاربری وصل نباشد، یا در چت مقصد ادمین با اجازهٔ مدیریت چت و حذف پیام نباشد، ربات به ارسال با خود ربات برمی‌گردد. در چت خصوصی با ربات (وقتی چت دامپ یا LEECH_LOG_CHAT ندارید) ارسال همیشه با ربات است.

اگر چندتا از -bt، -ut و -hl را با هم بدهید، -hl و بعد -ut اولویت دارند.

حالت ارسال را روی bot می‌گذارد. در این حالت سقف اندازهٔ تکه‌ها 2097152000 بایت است، حتی اگر حساب کاربری پرمیوم وصل باشد.

حالت ارسال را روی user می‌گذارد. اگر حساب پرمیوم باشد، سقف اندازهٔ تکه‌ها 4194304000 بایت می‌شود. اگر حساب کاربری وصل نباشد یا در چت مقصد دسترسی کافی نداشته باشد، ربات به ارسال با خود ربات برمی‌گردد.

-sv به‌تنهایی نمونه‌ای ۶۰ ثانیه‌ای از تکه‌های ۴ ثانیه‌ای می‌سازد. -sv 70:5 یعنی مدت نمونه ۷۰ ثانیه و هر تکه ۵ ثانیه؛ -sv :5 و -sv 70 هم مجازند. برای یک فایل تکی، ویدیوی اصلی و فایل SAMPLE.<name> کنار هم در یک پوشه قرار می‌گیرند. روی یک پوشه، برای همهٔ ویدیوهای آن نمونه ساخته می‌شود.

-ss به‌تنهایی ۱۰ عکس می‌گیرد و -ss 6 شش عکس، با فاصلهٔ مساوی در طول ویدیو. عکس‌ها در پوشه‌ای کنار ویدیو ساخته می‌شوند؛ در لیچ به‌صورت آلبوم عکس در پاسخ به پیام فرستاده می‌شوند و در میرور همراه بقیهٔ فایل‌ها آپلود می‌شوند.

اولین کلمه فرمت مقصد است: -ca mp3 همهٔ فایل‌های صوتی (به‌جز آن‌هایی که از قبل mp3 هستند) را تبدیل می‌کند. با + فقط پسوندهای نام‌برده تبدیل می‌شوند (-ca mp3 + flac ogg) و با - همه به‌جز پسوندهای نام‌برده (-ca mp3 - wav). فایل اصلی بعد از تبدیل موفق حذف می‌شود. فایلی که ویدیو هم باشد با -ca تبدیل نمی‌شود.

مثل -ca برای ویدیو: -cv mp4، -cv mp4 + mkv avi یا -cv mkv - webm flv (همه به mkv، به‌جز webm و flv). در متن راهنمای ربات، توضیح مثال آخر به‌اشتباه «به mp4» نوشته شده؛ فرمت مقصد همیشه اولین کلمه است. فایل اصلی بعد از تبدیل موفق حذف می‌شود.

رایج‌ترین شکل، نام یک کلید از دیکشنری FFMPEG_CMDS است که در FF Media Settings تنظیمات کاربری یا متغیر مالک تعریف شده: -ff subtitle. برای چند کلید، -ff را تکرار کنید: -ff subtitle -ff convert. اگر کلیدی پیدا نشود، ربات پیام Unknown FFmpeg Cmds key(s) می‌دهد.

فهرست را مستقیم هم می‌توانید بدهید، داخل کروشه: -ff ['-i mltb.mkv -c copy -c:s srt mltb.mkv']. هر دستور بدون کلمهٔ ffmpeg شروع می‌شود و باید -i داشته باشد. ورودی mltb.mkv یعنی فقط فایل‌های mkv، mltb.video همهٔ ویدیوها، mltb.audio همهٔ صداها و mltb بدون پسوند همهٔ فایل‌ها؛ پسوند خروجی (مثلاً mltb.mp3) فرمت خروجی را تعیین می‌کند. اگر -del را در دستور بگذارید، فایل اصلی بعد از اجرا حذف می‌شود.

دستورهای FFmpeg بعد از استخراج و پیش از متادیتا و تغییر نام اجرا می‌شوند. اگر مالک DISABLE_FF_MODE را فعال کرده باشد، این آرگومان پیام خطا می‌دهد.

قالب: key=value|key2=value2. متغیرهای پویا: {filename}، {basename} (نام بدون پسوند)، {extension}، {audiolang}، {sublang} و {year} (سالی که از نام فایل استخراج می‌شود). برای آوردن | در مقدار، \| بنویسید.

این مقدار با متادیتای سراسری METADATA شما در FF Media Settings ادغام می‌شود و در کلیدهای مشترک، مقدار -meta برنده است. متادیتای جداگانهٔ استریم‌های صدا، ویدیو و زیرنویس فقط از همان تنظیمات کاربری می‌آید.

صف فقط وقتی وجود دارد که مالک QUEUE_ALL، QUEUE_DOWNLOAD یا QUEUE_UPLOAD را تنظیم کرده باشد. -f هر دو مرحله را از صف عبور می‌دهد. برای تسکی که از قبل در صف است، دستور /forcestart را ببینید.

آپلود بعد از پایان دانلود، طبق قوانین معمول صف انجام می‌شود.

دانلود طبق قوانین معمول صف انجام می‌شود و فقط مرحلهٔ آپلود اجباری است.

با sync، طبق رفتار خود Rclone مقصد دقیقاً شبیه مبدأ می‌شود؛ یعنی فایل‌هایی که در مقصد هستند ولی در مبدأ نیستند حذف می‌شوند. فقط برای کلون بین دو مسیر Rclone اثر دارد.

مقدارها: doc (فقط document)، med (فقط ویدیو، صدا، عکس، انیمیشن، پیام صوتی و ویدیوپیام) و all. بدون -ct، مقدار CLONE_CONTENT_TYPE از Clone Settings یا متغیر مالک استفاده می‌شود. این آرگومان با -doc و -med که نحوهٔ ارسال در لیچ را تعیین می‌کنند فرق دارد.

پسوندها با فاصله و بدون نقطه نوشته می‌شوند: -ex mkv srt. این فهرست از EXCLUDED_EXTENSIONS لیچ جداست، پس فیلتر کلون روی چیزی که لیچ نادیده می‌گیرد اثری ندارد. بدون -ex، مقدار CLONE_EXCLUDED_EXTENSIONS استفاده می‌شود.

همهٔ فیلترهای -mn، -xn، -mc و -xc به بزرگی و کوچکی حروف حساس نیستند و با هم «و» می‌شوند. پیامی که نام فایل ندارد (مثل عکس یا متن) هیچ‌وقت با -mn جور نمی‌شود، پس این فیلتر آن‌ها را کنار می‌گذارد.

آرگومان‌ها با یک فاصله به هم وصل می‌شوند، پس به‌جای چند فاصله \s+ بنویسید. اگر الگو چیزی شبیه یک آرگومان دارد (مثلاً -e)، آن را داخل کروشه بگذارید: -mn [S01 -e 720p]؛ کروشه‌های دور الگو حذف می‌شوند. حداکثر طول الگو ۵۰۰ کاراکتر است. مقدار پیش‌فرض از CLONE_FILTERS می‌آید.

مانند -mn، به بزرگی و کوچکی حروف حساس نیست و با بقیهٔ فیلترها ترکیب می‌شود. مقدار پیش‌فرض از کلید xn در CLONE_FILTERS می‌آید.

کپشن پیام، یا اگر کپشن نداشت متن خود پیام، بررسی می‌شود. به بزرگی و کوچکی حروف حساس نیست و با بقیهٔ فیلترها ترکیب می‌شود.

به بزرگی و کوچکی حروف حساس نیست و با بقیهٔ فیلترها ترکیب می‌شود. مقدار پیش‌فرض از کلید xc در CLONE_FILTERS می‌آید.

در کلون تلگرام، به‌جای کپی کردن پیام‌ها آن‌ها را فوروارد می‌کند. بازه‌ها در دسته‌های ۱۰۰تایی فرستاده می‌شوند، پس برای مجموعه‌های بزرگ بسیار کم‌هزینه‌تر از کپی تک‌تک پیام‌هاست. پیام‌های چت‌هایی که فوروارد را ممنوع کرده‌اند (چه در حالت کپی و چه فوروارد) رد می‌شوند و گزارش پایانی می‌گوید کدام بازه‌ها را با /leech بگیرید.

شناسه یا لینک پوشه پذیرفته می‌شود و ربات پیش از ثبت، وجود آن را بررسی می‌کند. اگر نه -id و نه -index بدهید، دکمه‌های دسته‌ها نمایش داده می‌شوند.

در کد این نسخه، مقداری که ثبت می‌شود در مرحلهٔ آپلود خوانده نمی‌شود؛ توضیح دستور /category را ببینید.

می‌تواند همراه -id یا به‌تنهایی بیاید. مثل -id، در کد این نسخه در پیام پایانی خوانده نمی‌شود؛ دکمهٔ Index Link از INDEX_URL شما یا مالک ساخته می‌شود.

مقدار، نام دستور و آرگومان‌های دلخواه آن است و تا -inf، -exf یا -stv بعدی ادامه دارد؛ مثلاً -c mirror -up mrcc:remote:path -z pswd یا -c leech -d 0.5:30. برای هر آیتم جدیدی که از فیلترها عبور کند، ربات دستور را با لینک آیتم در RSS_CHAT می‌فرستد و تسک را شروع می‌کند. بدون -c، آیتم‌ها فقط در RSS_CHAT فرستاده می‌شوند.

| یعنی «و» و or یعنی «یا». مثلاً -inf 1080 or 720|mkv or mp4|hevc یعنی عنوان باید (1080 یا 720) و (mkv یا mp4) و hevc داشته باشد. or را فقط بین گزینه‌های هم‌نوع بگذارید؛ 1080|mp4 or 720|web معنای (1080) و (mp4 یا 720) و (web) می‌دهد. برای جلوگیری از تطبیق اشتباه، می‌توانید فاصله یا کاراکتر ثابت کنار کلمه بگذارید (مثل 1080 ).

قواعد | و or مثل -inf است: -exf flv or web|xxx آیتم‌هایی را کنار می‌گذارد که (flv یا web) و xxx داشته باشند.

-stv true یعنی حساس و -stv false یعنی غیرحساس. اگر ننویسید، فیلترها حساس نیستند.