راهنمای استفاده
راهنمای لیچ
ارسال فایل‌ها در خود تلگرام با لیچ؛ مقصد ارسال، اندازهٔ تکه‌ها، سند یا رسانه، تامبنیل، کپشن، چت‌های دامپ و حالت ارسال.
لیچ (Leech): دانلود و ارسال فایل در خود تلگرام. ربات فایل را روی سرور دانلود می‌کند، همان پردازش‌های میرور (استخراج، فشرده‌سازی، تغییر نام و…) را انجام می‌دهد و سپس خود فایل‌ها را در تلگرام می‌فرستد. فایل‌هایی که از سقف تلگرام بزرگ‌ترند تکه‌تکه می‌شوند.
دستورهای لیچ
| دستور | موتور دانلود |
|---|---|
/leech یا /l | Aria2، به‌علاوهٔ ابزار مخصوص هر منبع (همان منابع /mirror) |
/qbleech یا /ql | qBittorrent، فقط تورنت |
/jdleech یا /jl | JDownloader؛ به‌طور پیش‌فرض غیرفعال |
/nzbleech یا /nl | SABnzbd؛ به‌طور پیش‌فرض غیرفعال |
/ytdlleech یا /yl | yt-dlp؛ راهنمای yt-dlp |
منبع‌ها، فشرده‌سازی، استخراج، تغییر نام و چند لینک دقیقاً مثل میرور کار می‌کنند؛ راهنمای میرور را ببینید. اگر مالک DISABLE_LEECH را فعال کرده باشد، دستورهای لیچ پاسخ می‌دهند که غیرفعال‌اند (این متغیر روی /ytdlleech اثر ندارد).
فایل‌ها کجا فرستاده می‌شوند؟
ربات هر فایل را اول در یک چت اصلی آپلود می‌کند و بعد، در صورت نیاز، از آنجا در چت‌های دیگر کپی می‌کند.
چت اصلی به این ترتیب انتخاب می‌شود:
- چتی که با
-udبرای همین تسک انتخاب کرده‌اید. - در غیر این صورت
LEECH_LOG_CHAT(متغیر مالک). - در غیر این صورت، همان چتی که دستور را در آن فرستاده‌اید؛ فایل‌ها در پاسخ به پیام دستور می‌آیند.
بعد از آپلود، ربات نسخه‌هایی کپی می‌کند در:
- چتی که با
-upداده‌اید: شناسهٔ عددی،@username،pmبرای چت خصوصی خودتان، یاchat_id|topic_idبرای یک تاپیک. - همهٔ چت‌های
Leech Dump Chatsشخصی شما (بخشLeech Settingsدر/usetting). - چت خصوصی شما، اگر مالک
BOT_PMرا فعال کرده باشد.
LEECH_LOG_CHAT شناسهٔ یک چت است و برای تاپیک می‌توانید chat_id|topic_id بنویسید. متغیر قدیمی LEECH_DUMP_CHAT اگر LEECH_LOG_CHAT خالی باشد، خودکار به آن منتقل می‌شود.
وقتی فایل‌ها در گروه، کانال یا LEECH_LOG_CHAT فرستاده شوند، پیام پایان کار فهرست آن‌ها را با لینک پیامشان نشان می‌دهد. وقتی MEDIA_STORE روشن است و فایل‌ها در سوپرگروه، کانال یا LEECH_LOG_CHAT فرستاده شده‌اند، کنار هر فایل لینک‌های Store Link و Share Link هم می‌آید که با باز کردنشان ربات فایل را در چت خصوصی برایتان می‌فرستد.
چت‌های دامپ
چت دامپ (چتی که نسخه‌ای از فایل‌ها در آن ذخیره می‌شود) دو منبع دارد:
| منبع | کجا تنظیم می‌شود | رفتار |
|---|---|---|
| چت‌های دامپ مالک | متغیر LEECH_DUMP_CHATS، به شکل {"name": chat_id} | فقط وقتی استفاده می‌شوند که با -ud name انتخابشان کنید |
| چت‌های دامپ شما | /usetting ← Leech Settings ← Leech Dump Chats | هر لیچ شما در همهٔ آن‌ها کپی می‌شود و هرکدام با -ud name هم قابل انتخاب است |
چت‌های شخصی را در Leech Dump Chats هر کدام در یک خط بنویسید، مثل Movies -1001234567890 یا برای تاپیک Movies -1001234567890|12؛ شکل دیکشنری هم پذیرفته می‌شود. ربات همان لحظه همهٔ چت‌ها را بررسی می‌کند، پس باید از قبل در آن‌ها ادمین باشد.
با -ud A چت اصلی همین تسک عوض می‌شود. نام اول در فهرست شما و بعد در فهرست مالک جستجو می‌شود و اگر در هر دو باشد، مال شما برنده است. اگر نام پیدا نشود، ربات دکمه‌های چت‌های تعریف‌شده را نشان می‌دهد. شناسهٔ عددی یا @username را هم می‌توانید مستقیم به -ud بدهید.
اندازهٔ تکه‌ها
تلگرام برای ربات‌ها سقف حدود ۲ گیگابایت (2097152000 بایت) دارد. اگر مالک USER_SESSION_STRING یک حساب پرمیوم را تنظیم کرده باشد، سقف برای ارسال با آن حساب 4194304000 بایت (حدود ۴ گیگابایت) است.
اندازهٔ تکه‌ها به این ترتیب تعیین می‌شود:
-spهمین تسک، مثل-sp 1gb،-sp 500mbیا عدد به بایت.Leech Split SizeدرLeech Settingsشما (به بایت یا باgbوmb، مثل2.5gb).- متغیر
LEECH_SPLIT_SIZEمالک. اگر این متغیر0، دقیقاً برابر مقدار پیش‌فرض2097152000یا بیشتر از سقف مجاز باشد، هنگام راه‌اندازی روی سقف مجاز گذاشته می‌شود؛ یعنی با حساب پرمیوم روی4194304000.
مقدار نهایی هر تسک هیچ‌وقت از سقف حالت ارسال بیشتر نمی‌شود: در حالت ارسال با ربات (-bt) همیشه 2097152000، حتی اگر حساب پرمیوم وصل باشد.
ویدیوهایی که به‌صورت رسانه فرستاده می‌شوند با FFmpeg به چند ویدیوی کوتاه‌تر و قابل پخش تقسیم می‌شوند و بقیهٔ فایل‌ها به تکه‌های باینری. با EQUAL_SPLITS (یا دکمهٔ Enable Equal Splits) همهٔ تکه‌ها هم‌اندازه می‌شوند. اگر -z بدهید، آرشیو zip خودش به چند بخش تقسیم می‌شود.
سند یا رسانه
به‌طور پیش‌فرض نوع ارسال از AS_DOCUMENT می‌آید که در Leech Settings با دکمهٔ Send As Document یا Send As Media برای خودتان عوضش می‌کنید. برای یک تسک:
-docهمه‌چیز را به‌صورت سند می‌فرستد.-medویدیو، صدا و عکس را به‌صورت رسانه می‌فرستد تا در تلگرام پخش شوند. فایل‌های دیگر همیشه سند می‌مانند.
اگر هر دو را بدهید، -doc برنده است.
تصویر بندانگشتی
تصویر بندانگشتی (Thumbnail) یا همان تامبنیل، به این ترتیب انتخاب می‌شود:
-tهمین تسک: لینک مستقیم تصویر، لینک پیام تلگرامی که عکس یا سند دارد، یاnone.- تامبنیل شخصی شما در
Leech Settings←Thumbnail Settings. - تامبنیلی که yt-dlp کنار ویدیو دانلود کرده، یا کاور فایل صوتی.
- تامبنیل خودکار: اگر
AUTO_THUMBNAIL(یا دکمهٔ مربوطه درThumbnail Settings) روشن باشد و مالکTMDB_ACCESS_TOKENرا تنظیم کرده باشد، پوستر از TMDB و بر اساس نام فایل گرفته می‌شود. - برای ویدیوهایی که رسانه فرستاده می‌شوند، چیدمان چندفریمی
-tlیاTHUMBNAIL_LAYOUT(مثل3x3). - در آخر، یک فریم از خود ویدیو.
-t none تامبنیل شخصی و خودکار را برای آن تسک کنار می‌گذارد، اما ممکن است ربات همچنان فریمی از خود ویدیو را بگذارد.
پیشوند، پسوند و کپشن
این‌ها در Leech Settings شما تنظیم می‌شوند و اگر خالی باشند، متغیرهای هم‌نام مالک استفاده می‌شوند:
| تنظیم | کار |
|---|---|
LEECH_PREFIX | پیشوند: قبل از نام هر فایل می‌آید. تگ HTML در کپشن می‌ماند و از نام فایل حذف می‌شود. برای فاصله \s بنویسید. |
LEECH_SUFFIX | پسوند: بعد از نام و قبل از پسوند فایل (مثل .mkv) می‌آید؛ همان قواعد پیشوند. |
LEECH_CAPTION | کپشن: کل کپشن را جایگزین می‌کند. |
LEECH_FONT | متغیر مالک؛ نام یک تگ HTML که کپشن پیش‌فرض (نام فایل) داخل آن قرار می‌گیرد. |
در LEECH_CAPTION این متغیرها جایگزین می‌شوند: {filename}، {size}، {duration}، {quality}، {languages}، {subtitles}، {md5_hash}، {mime_type}، {prefilename} و {precaption} (کپشن اصلی پیامی که فایل از آن آمده). بعد از قالب می‌توانید بخش‌هایی مثل |find:replace اضافه کنید تا متنی در نتیجه عوض شود. برای آوردن خود کاراکترهای |، { و } بنویسید \|، \{ و \}.
<b>{filename}</b>
Size: {size} \| Duration: {duration}|.mkv:در این مثال \| یک خط عمودی واقعی در کپشن می‌گذارد و بخش آخر (|.mkv:) عبارت .mkv را از متن نهایی حذف می‌کند.
گروه رسانه‌ای
اگر MEDIA_GROUP روشن باشد (دکمهٔ Enable Media Group در Leech Settings)، تکه‌های یک فایل تکه‌شده بعد از آپلود به‌صورت یک آلبوم تلگرام کنار هم قرار می‌گیرند؛ هر آلبوم حداکثر ۱۰ فایل.
حالت ارسال: ربات، حساب کاربری یا ترکیبی
متغیر TRANSMISSION_MODE (پیش‌فرض both) مشخص می‌کند فایل‌ها با کدام حساب فرستاده شوند:
| حالت | آرگومان هر تسک | رفتار |
|---|---|---|
bot | -bt | همه با حساب ربات؛ سقف ۲ گیگابایت |
user | -ut | همه با حساب USER_SESSION_STRING |
both | -hl | فایل‌های تا ۲ گیگابایت با ربات و بزرگ‌ترها با حساب کاربری |
حالت‌های user و both به ربات برمی‌گردند اگر حساب کاربری وصل نباشد، یا در چت مقصد ادمین با اجازهٔ مدیریت چت و حذف پیام نباشد. در چت خصوصی با ربات (وقتی -ud یا LEECH_LOG_CHAT ندارید) ارسال همیشه با ربات است. اگر چند آرگومان را با هم بدهید، -hl و بعد -ut اولویت دارند.
مثال‌ها
| هدف | دستور |
|---|---|
| لیچ ساده در همین چت | /leech https://example.com/video.mp4 |
| تکه‌های ۱ گیگابایتی، به‌صورت سند | /l https://example.com/big.iso -sp 1gb -doc |
| ارسال در چت دامپ نام‌دار | /leech https://example.com/file.zip -ud Movies |
| یک نسخه هم در چت خصوصی خودتان | /leech https://example.com/file.zip -up pm |
| ویدیو به‌صورت رسانه با تامبنیل دلخواه | /leech https://example.com/clip.mp4 -med -t https://example.com/cover.jpg |
| تورنت با qBittorrent، فقط فایل‌های انتخابی | /qbleech magnet:?xt=urn:btih:0123456789abcdef0123456789abcdef01234567 -s |
| یک بازه از پیام‌های تلگرام | /leech (با ریپلای روی https://t.me/c/1234567/100-120) |
| آرشیو رمزدار ۵۰۰ مگابایتی | /leech https://example.com/folder.tar -z secret -sp 500mb |
| ارسال ترکیبی با حساب پرمیوم | /leech https://example.com/huge.mkv -hl -ud Archive |
همچنین ببینید
- آرگومان‌ها: بخش «ارسال در تلگرام (لیچ)»
- تنظیمات کاربری:
Leech Settings، تامبنیل و چت‌های دامپ - مرجع متغیرها:
LEECH_SPLIT_SIZE،LEECH_LOG_CHAT،LEECH_DUMP_CHATSوTRANSMISSION_MODE