راهنمای استفاده

راهنمای میرور

چطور لینک، تورنت، فایل تلگرام یا مسیر ابری را دانلود کنید و در گوگل درایو، Rclone، Mega یا سرویس‌های آپلود مستقیم بگذارید.

میرور (Mirror): دانلود و آپلود در فضای ابری. ربات فایل را روی سرور خودش دانلود می‌کند، در صورت نیاز روی آن کار می‌کند (استخراج، فشرده‌سازی، تغییر نام و…) و نتیجه را در مقصد آپلود شما می‌گذارد. در پایان، پیامی با لینک فایل در آن مقصد دریافت می‌کنید.

دستورهای میرور

فهرست کامل و سطح دسترسی هر دستور در صفحهٔ دستورات آمده است.

شکل کلی دستور

/mirror <link> -arg value -arg value

لینک را کنار دستور بنویسید، یا روی پیامی که لینک یا فایل دارد ریپلای کنید و فقط دستور و آرگومان‌ها را بفرستید. اگر دستور را بدون هیچ ورودی بفرستید، ربات راهنمای آرگومان‌ها را با دکمه نشان می‌دهد.

منبع‌ها

لینک‌های تلگرام سه شکل دارند: عمومی (https://t.me/channel_name/123)، خصوصی (tg://openmessage?user_id=...&message_id=...) و سوپرگروه یا کانال خصوصی (https://t.me/c/1234567/123). برای چند پیام پشت سر هم، بازه بدهید: https://t.me/channel_name/100-150. طبق راهنمای ربات، لینک بازه فقط وقتی کار می‌کند که روی آن ریپلای کنید و هر پیام یک تسک جدا می‌شود.

انتخاب مقصد

مقصد پیش‌فرض

اگر -up ندهید، مقصد از DEFAULT_UPLOAD تعیین می‌شود. هر کاربر می‌تواند در /usetting بخش General Settings با دکمهٔ Swap to GDRIVE API Mode یا Swap to RCLONE Mode آن را برای خودش عوض کند. در حالت گوگل درایو فایل به GDRIVE_ID می‌رود و در حالت Rclone به RCLONE_PATH؛ هر دو اول از تنظیمات شما و بعد از متغیرهای مالک خوانده می‌شوند. اگر هیچ‌کدام تنظیم نشده باشد، تسک با خطای No Upload Destination! متوقف می‌شود.

مقدارهای -up

توکن مالک یا توکن خودتان

ربات می‌تواند با اعتبارنامه‌های مالک یا اعتبارنامه‌هایی که خودتان در /usetting بارگذاری کرده‌اید کار کند. پیشوند را بدون فاصله قبل از لینک، شناسه یا مسیر بنویسید؛ هم برای منبع و هم برای -up.

اگر در General Settings دکمهٔ Swap to USER token/config را بزنید، ربات پیشوندهای mtp: و mrcc: را خودش اضافه می‌کند و دیگر لازم نیست بنویسید.

دستهٔ گوگل درایو

با -gc پوشهٔ مقصد را از روی نام یک دسته انتخاب می‌کنید؛ دسته‌ها از فایل categories.txt مالک، دستهٔ Root (همان GDRIVE_ID) و، اگر DRIVE_CATEGORY_MODE فعال باشد، دسته‌های شخصی شما می‌آیند. اگر نام پیدا نشود، ربات دکمه‌های دسته‌ها را نشان می‌دهد. جزئیات در آرگومان‌ها.

سرویس‌های آپلود مستقیم

سرویس آپلود مستقیم (Uphoster) سایتی است که برای هر فایل لینک دانلود مستقیم می‌دهد. با /uphoster، مقصد از -up خوانده نمی‌شود، بلکه از /usetting بخش Uphoster Settings: با دکمهٔ Change Destination ⇋ یک یا چند سرویس از بین gofile (پیش‌فرض)، buzzheavier، pixeldrain، devuploads و vikingfile انتخاب می‌کنید و توکن هرکدام را در صفحهٔ Tools همان سرویس وارد می‌کنید. با چند سرویس، فایل هم‌زمان در همه آپلود می‌شود و برای هرکدام دکمهٔ لینک جدا می‌گیرید.

یوتیوب

دستورهای خانوادهٔ /mirror آرگومان -yt را هم می‌شناسند که خروجی را به‌جای فضای ابری در یوتیوب آپلود می‌کند. این آرگومان در راهنمای ربات نیامده است؛ شرایطش را در توضیح -yt در آرگومان‌ها ببینید.

فشرده‌سازی و استخراج

• -e آرشیوها را باز می‌کند و -e password آرشیوهای رمزدار را. فایل‌های آرشیو بعد از استخراج موفق حذف می‌شوند.
• -z خروجی را در یک آرشیو zip می‌گذارد و -z password آرشیو رمزدار می‌سازد. آرشیو بدون فشرده‌سازی ساخته می‌شود و هدفش بسته‌بندی است.
• با هر دو (-e -z)، ربات اول استخراج و بعد فشرده‌سازی می‌کند.
• -j فایل‌های تکه‌شده را پیش از استخراج به هم وصل می‌کند. فقط روی پوشه کار می‌کند، پس معمولاً همراه -m می‌آید.
• در /nzbmirror استخراج را SABnzbd انجام می‌دهد و ربات -e را خودش اضافه می‌کند.

تغییر نام

• -n new name.ext نام خروجی را عوض می‌کند. پسوند را خودتان بنویسید. طبق راهنمای ربات روی تورنت‌ها کار نمی‌کند.
• -ns با الگوهای regex بخش‌هایی از نام همهٔ فایل‌ها را عوض یا حذف می‌کند. قالب درست pattern:replace:count:flag است و قاعده‌ها با | جدا می‌شوند؛ مثلاً -ns 720p:1080p|sample:.
• اگر NAME_SWAP را در Misc Settings تنظیم کرده باشید، روی همهٔ تسک‌هایتان اعمال می‌شود، مگر اینکه برای یک تسک -ns بدهید.

چند لینک و دانلود دسته‌ای

-i: روی اولین لینک یا فایل ریپلای کنید و تعداد را بدهید. ربات همان دستور را روی پیام‌های بعدی هم اجرا می‌کند:

/mirror -i 5

-b: روی یک پیام متنی یا فایل .txt که در هر خط آن یک لینک است ریپلای کنید. هر خط می‌تواند آرگومان‌های خودش را داشته باشد و آرگومان‌های کنار دستور به همهٔ خط‌ها اضافه می‌شوند. با -b 2:6 فقط بخشی از فهرست اجرا می‌شود (شمارش از صفر).

https://example.com/a.zip -n first.zip
https://example.com/b.zip -z
https://example.com/c.rar -e -up remote:other

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

انتخاب فایل‌های تورنت و سید کردن

• با -s دانلود تورنت یا NZB پیش از شروع متوقف می‌شود و دکمه‌ای برای صفحهٔ وب انتخاب فایل می‌آید. این صفحه روی وب‌سرور ربات است و به BASE_URL نیاز دارد؛ اگر BASE_URL تنظیم نشده باشد، -s نادیده گرفته می‌شود.
• برای تسکی که بدون -s شروع شده، دستور /sel_<GID> را از پیام وضعیت بزنید.
• با -d تورنت بعد از دانلود سید می‌شود: -d 0.7:10 (نسبت و زمان به دقیقه)، -d 0.7 یا -d :10. سید کردن فقط برای تورنت‌هاست و وقتی چند لینک با -m در یک پوشه جمع شوند انجام نمی‌شود.

ترتیب پردازش پیش از آپلود

بعد از پایان دانلود، ربات به این ترتیب روی فایل‌ها کار می‌کند. پیش از همه، فایل‌هایی که پسوندشان در EXCLUDED_EXTENSIONS (شما یا مالک) است کنار گذاشته می‌شوند.

1. اتصال فایل‌های تکه‌شده (-j)
2. استخراج (-e)
3. دستورهای FFmpeg (-ff)
4. متادیتا (-meta و متادیتای FF Media Settings)
5. جایگزینی نام (-ns یا NAME_SWAP)
6. عکس صفحه (-ss)
7. تبدیل صدا و ویدیو (-ca و -cv)
8. ویدیوی نمونه (-sv)
9. فشرده‌سازی (-z)

صف و محدودیت‌ها

اگر مالک برای تعداد تسک‌های هم‌زمان صف گذاشته باشد (QUEUE_ALL، QUEUE_DOWNLOAD و QUEUE_UPLOAD)، تسک‌ها در صف می‌مانند. با -f هر دو مرحله، با -fd فقط دانلود و با -fu فقط آپلود را اجباری کنید؛ برای تسکی که از قبل در صف است از /forcestart استفاده کنید. سقف حجم‌ها (مثل TORRENT_LIMIT یا DIRECT_LIMIT) برای کاربران سودو اعمال نمی‌شود. همهٔ این متغیرها در مرجع متغیرها آمده‌اند.

مثال‌ها

همچنین ببینید

• آرگومان‌ها: توضیح کامل همهٔ آرگومان‌ها با مثال
• تنظیمات کاربری: توکن، کانفیگ، مقصد پیش‌فرض و سرویس‌های آپلود مستقیم شخصی
• تنظیمات ربات و مرجع متغیرها: متغیرهایی مثل DEFAULT_UPLOAD، GDRIVE_ID و RCLONE_PATH