دستورات

همهٔ دستورات

۶۳ دستور، با نام‌های کوتاهی که ربات می‌شناسد. اگر در CMD_SUFFIX پسوندی گذاشته باشید، به آخر همهٔ دستورها اضافه می‌شود؛ مثلاً با CMD_SUFFIX = "2" دستور /mirror به /mirror2 تبدیل می‌شود.

همهکاربران مجازسودو و مالکفقط مالک

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

شروع کار با ربات، ورود با رمز، راهنما و وضعیت کلی سرور.

/start

همه

پیام خوش‌آمد ربات را نشان می‌دهد و چت خصوصی شما را برای دریافت فایل‌ها ثبت می‌کند.

کاربران مجاز پیام شروع را با اشاره به /help می‌بینند و بقیه پیامی دربارهٔ مجاز نبودن. شناسهٔ شما هم در فهرست کاربرانی ذخیره می‌شود که ربات را در چت خصوصی استارت کرده‌اند؛ همان فهرستی که /broadcast برایش پیام می‌فرستد.

ربات از /start با پارامتر برای لینک‌های داخلی خودش هم استفاده می‌کند: لینک‌های Store Link فایل‌های لیچ‌شده (وقتی MEDIA_STORE فعال است) و دکمهٔ Verify Access Token وقتی مالک VERIFY_TIMEOUT را تنظیم کرده است.

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

نمونه

/start

/login

همه

با رمز LOGIN_PASS برای همیشه از تأیید دوره‌ای توکن دسترسی معاف می‌شوید.

وقتی مالک VERIFY_TIMEOUT را تنظیم کرده باشد، کاربرانی که سودو نیستند هر چند وقت یک بار باید توکن دسترسی را تأیید کنند. اگر LOGIN_PASS هم تنظیم شده باشد، /login <password> رمز را (بدون حساسیت به بزرگی و کوچکی حروف) بررسی می‌کند و شما را دائم وارد می‌کند.

این دستور کسی را مجاز نمی‌کند؛ فقط مرحلهٔ تأیید توکن را برمی‌دارد. اگر LOGIN_PASS خالی باشد، هر رمزی پاسخ Wrong Password! می‌گیرد. در منوی دستورهای ربات فقط وقتی نشان داده می‌شود که LOGIN_PASS تنظیم شده باشد.

نمونه

/login my-secret-pass

/help/h

کاربران مجاز

فهرست همهٔ دستورها را با توضیح کوتاه نشان می‌دهد.

فهرست، دستورهای افزونه‌های فعال را هم شامل می‌شود. برای دیدن جزئیات آرگومان‌ها، دستورهایی مثل /mirror، /ytdl یا /clone را بدون لینک بفرستید؛ ربات راهنما را با دکمه‌ای برای هر موضوع (مثل New-Name یا Upload-Destination) نشان می‌دهد.

توضیح فارسی همهٔ آرگومان‌ها در صفحهٔ آرگومان‌ها آمده است.

نمونه

/help

/ping

کاربران مجاز

زمان پاسخ ربات را به میلی‌ثانیه نشان می‌دهد.

مدت زمان فرستادن یک پیام را اندازه می‌گیرد و Pong! را همراه عدد میلی‌ثانیه برمی‌گرداند. متن /help می‌گوید این دستور فقط برای مالک و سودوست، اما handler آن با فیلتر کاربران مجاز ثبت شده است.

نمونه

/ping

/stats/st

کاربران مجاز

آمار ربات، سیستم‌عامل، مخزن کد و نسخهٔ بسته‌ها را نشان می‌دهد.

صفحه‌ها با دکمه‌های Bot Stats، OS Stats، Repo Stats، Pkgs Stats، Task Limits و Sys Tasks باز می‌شوند. در Sys Tasks پردازه‌های پرمصرف سرور فهرست می‌شوند و فقط مالک ربات می‌تواند آن‌ها را متوقف کند.

نمونه

/stats

میرور

میرور (Mirror): دانلود و آپلود در فضای ابری. هر دستور با یک موتور دانلود متفاوت کار می‌کند و خروجی را در گوگل درایو، Rclone یا Mega آپلود می‌کند.

/mirror/m

کاربران مجاز

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

منبع می‌تواند لینک مستقیم، لینک سایت‌هایی که ربات لینک مستقیمشان را استخراج می‌کند، مگنت یا فایل .torrent (با Aria2)، لینک یا شناسهٔ گوگل درایو، مسیر Rclone، لینک Mega، یا فایل و لینک پیام تلگرام باشد. لینک را کنار دستور بنویسید یا روی پیام حاوی لینک یا فایل ریپلای کنید. لینک باید قبل از آرگومان‌ها بیاید.

مقصد از -up تعیین می‌شود و بدون آن از DEFAULT_UPLOAD. اگر لینک رمز بخواهد، رمز را با :: بعد از لینک بنویسید: https://example.com/file::password.

اگر مالک DISABLE_MIRROR را فعال کرده باشد، ربات پاسخ می‌دهد این دستور غیرفعال است؛ DISABLE_TORRENTS تورنت‌ها و DISABLE_MEGA لینک‌های Mega را می‌بندد.

نمونه

/mirror https://example.com/file.zip
/m https://example.com/archive.rar -e -up gd
/mirror magnet:?xt=urn:btih:0123456789abcdef0123456789abcdef01234567 -s
/m <reply to a file> -n new name.zip -z

آرگومان‌ها:-n-ns-up-rcf-gc-yt-z-e-j-i-b-m-s-d-au-ap-h-ad-seedr-sv-ss-ca-cv-ff-meta-f-fd-fu

/qbmirror/qm

کاربران مجاز

مگنت یا فایل تورنت را با qBittorrent دانلود و در مقصد ابری آپلود می‌کند.

دستورهایی که با qb شروع می‌شوند فقط برای تورنت هستند. انتخاب فایل با -s (نیازمند BASE_URL) و سید کردن با -d در این موتور هم کار می‌کند. اگر مالک DISABLE_TORRENTS یا DISABLE_MIRROR را فعال کرده باشد، تسک شروع نمی‌شود.

نمونه

/qbmirror magnet:?xt=urn:btih:0123456789abcdef0123456789abcdef01234567
/qm <reply to a .torrent file> -s -d 1.0:60

آرگومان‌ها:-n-ns-up-rcf-gc-yt-z-e-j-i-b-m-s-d-ad-sv-ss-ca-cv-ff-meta-f-fd-fu

/jdmirror/jm

کاربران مجاز

لینک را با JDownloader دانلود و در مقصد ابری آپلود می‌کند.

به حساب MyJDownloader (JD_EMAIL و JD_PASS) نیاز دارد. DISABLE_JD به‌طور پیش‌فرض True است و تا مالک آن را خاموش نکند، ربات پاسخ می‌دهد JDownloader غیرفعال است. فایل .dlc را هم با ریپلای می‌پذیرد.

با -s، ربات تا ۱۰ دقیقه صبر می‌کند تا فایل‌های ناخواسته را در سایت MyJDownloader حذف یا تنظیم کنید و Done Selecting را بزنید.

نمونه

/jdmirror https://example.com/download/abc123
/jm <reply to a .dlc file> -s

آرگومان‌ها:-n-ns-up-rcf-gc-yt-z-e-j-i-b-m-s-sv-ss-ca-cv-ff-meta-f-fd-fu

/nzbmirror/nm

کاربران مجاز

فایل یا لینک NZB را با SABnzbd از Usenet دانلود و در مقصد ابری آپلود می‌کند.

به سرورهای Usenet (USENET_SERVERS) نیاز دارد و DISABLE_NZB به‌طور پیش‌فرض True است. اگر -e ننوشته باشید، ربات خودش آن را اضافه می‌کند تا SABnzbd بعد از دانلود فایل‌ها را بازسازی و استخراج کند.

اگر به‌جای لینک، شناسهٔ یک نتیجهٔ NZBHydra را بدهید، ربات با HYDRA_IP و HYDRA_API_KEY لینک NZB را خودش می‌سازد. برای جستجو در NZBHydra از دستور افزونه‌ای /nzbsearch استفاده کنید.

نمونه

/nzbmirror https://example.com/file.nzb
/nm <reply to a .nzb file> -s
/nzbmirror 1a2b3c4d5e

آرگومان‌ها:-n-ns-up-rcf-gc-yt-z-e-j-i-b-m-s-sv-ss-ca-cv-ff-meta-f-fd-fu

لیچ

لیچ (Leech): دانلود و ارسال فایل در خود تلگرام. همان موتورهای دانلود میرور، اما خروجی به‌صورت فایل در چت تلگرام فرستاده می‌شود.

/leech/l

کاربران مجاز

لینک، فایل یا تورنت را دانلود و خود فایل‌ها را در تلگرام می‌فرستد.

همان منابع /mirror را می‌پذیرد، از جمله لینک پیام‌های تلگرام؛ برای کانال‌ها و چت‌های خصوصی به USER_SESSION_STRING نیاز است. فایل‌های بزرگ‌تر از اندازهٔ تکه‌ها (-sp یا LEECH_SPLIT_SIZE) تکه‌تکه می‌شوند.

چت مقصد به ترتیب چت -ud، LEECH_LOG_CHAT یا همان چتی است که دستور را فرستاده‌اید؛ سپس نسخه‌ای در چت -up و همهٔ چت‌های دامپ شخصی شما کپی می‌شود. پیشوند، پسوند، کپشن و تامبنیل از تنظیمات کاربری می‌آیند.

اگر مالک DISABLE_LEECH را فعال کرده باشد، ربات پاسخ می‌دهد این دستور غیرفعال است.

نمونه

/leech https://example.com/video.mp4
/l https://example.com/big.iso -sp 1gb -doc
/leech https://t.me/c/1234567/120
/l <reply to a link> -z secret -ud Archive

آرگومان‌ها:-n-ns-up-ud-rcf-z-e-j-i-b-m-s-d-au-ap-h-ad-seedr-t-sp-doc-med-tl-hl-bt-ut-sv-ss-ca-cv-ff-meta-f-fd-fu

/qbleech/ql

کاربران مجاز

مگنت یا فایل تورنت را با qBittorrent دانلود و در تلگرام می‌فرستد.

مثل /qbmirror فقط برای تورنت است، اما خروجی مثل /leech به تلگرام فرستاده می‌شود. انتخاب فایل با -s و سید کردن با -d کار می‌کند.

نمونه

/qbleech magnet:?xt=urn:btih:0123456789abcdef0123456789abcdef01234567 -s
/ql <reply to a .torrent file> -med

آرگومان‌ها:-n-ns-up-ud-z-e-j-i-b-m-s-d-ad-t-sp-doc-med-tl-hl-bt-ut-sv-ss-ca-cv-ff-meta-f-fd-fu

/jdleech/jl

کاربران مجاز

لینک را با JDownloader دانلود و در تلگرام می‌فرستد.

شرایط /jdmirror را دارد: حساب MyJDownloader و خاموش بودن DISABLE_JD (که به‌طور پیش‌فرض True است).

نمونه

/jdleech https://example.com/download/abc123

آرگومان‌ها:-n-ns-up-ud-z-e-j-i-b-m-s-t-sp-doc-med-tl-hl-bt-ut-sv-ss-ca-cv-ff-meta-f-fd-fu

/nzbleech/nl

کاربران مجاز

فایل یا لینک NZB را با SABnzbd دانلود و در تلگرام می‌فرستد.

شرایط /nzbmirror را دارد: USENET_SERVERS و خاموش بودن DISABLE_NZB. -e خودکار اضافه می‌شود و شناسهٔ NZBHydra هم به‌جای لینک پذیرفته می‌شود.

نمونه

/nzbleech https://example.com/file.nzb
/nl <reply to a .nzb file>

آرگومان‌ها:-n-ns-up-ud-z-e-j-i-b-m-s-t-sp-doc-med-tl-hl-bt-ut-sv-ss-ca-cv-ff-meta-f-fd-fu

yt-dlp

دانلود ویدیو و صدا از یوتیوب و هر سایتی که yt-dlp پشتیبانی می‌کند، با انتخاب کیفیت از روی دکمه.

/ytdl/y

کاربران مجاز

ویدیو یا صدا را با yt-dlp دانلود و در مقصد ابری آپلود می‌کند.

فقط لینک می‌پذیرد، نه فایل تلگرام. ربات اطلاعات لینک را می‌گیرد، دکمه‌های کیفیت را نشان می‌دهد و تا ۱۲۰ ثانیه منتظر انتخاب شما می‌ماند؛ اگر در گزینه‌های yt-dlp کلید format تعیین شده باشد، این مرحله رد می‌شود مگر -s بدهید.

گزینه‌های yt-dlp از -opt، YT_DLP_OPTIONS شما یا متغیر مالک می‌آیند و فایل کوکی از YT-DLP Settings. فهرست سایت‌ها: supportedsites.md.

اگر مالک DISABLE_YTDLP را فعال کرده باشد، ربات پاسخ می‌دهد دانلودهای yt-dlp غیرفعال است.

نمونه

/ytdl https://example.com/watch?v=abc123
/y https://example.com/playlist?list=xyz -up gd
/ytdl https://example.com/watch?v=abc123 -opt {'format': 'ba/b-mp3-320'}

آرگومان‌ها:-n-ns-up-rcf-gc-z-i-b-m-s-opt-sv-ss-ca-cv-ff-meta-f-fd-fu

/ytdlleech/yl

کاربران مجاز

ویدیو یا صدا را با yt-dlp دانلود و در تلگرام می‌فرستد.

مثل /ytdl با همان دکمه‌های کیفیت، اما خروجی مثل /leech به تلگرام می‌رود. اگر تامبنیل شخصی، -t یا چیدمان تامبنیل (-tl یا THUMBNAIL_LAYOUT) نداشته باشید، تامبنیلی که yt-dlp دانلود می‌کند روی ویدیو گذاشته می‌شود.

نمونه

/ytdlleech https://example.com/watch?v=abc123
/yl https://example.com/watch?v=abc123 -s -med

آرگومان‌ها:-n-ns-up-ud-z-i-b-m-s-opt-t-sp-doc-med-tl-hl-bt-ut-sv-ss-ca-cv-ff-meta-f-fd-fu

سرویس آپلود مستقیم

سرویس آپلود مستقیم (Uphoster): آپلود فایل در سایت‌هایی مثل Gofile که برای هر فایل لینک دانلود مستقیم می‌دهند.

/uphoster/up

کاربران مجاز

فایل را دانلود و در سرویس‌های آپلود مستقیم مثل Gofile آپلود می‌کند.

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

برای Gofile، BuzzHeavier و PixelDrain پیش از شروع بررسی می‌شود که توکن یا کلید (از تنظیمات شما یا متغیرهای مالک) وجود داشته باشد. -up در این دستور اثری ندارد و DISABLE_MIRROR هم آن را نمی‌بندد.

مثل /nzbmirror، اگر به‌جای لینک شناسهٔ NZBHydra بدهید، دانلود با SABnzbd انجام می‌شود.

نمونه

/uphoster https://example.com/file.zip
/up <reply to a file> -z secret

آرگومان‌ها:-n-ns-rcf-z-e-j-i-b-m-s-d-au-ap-h-ad-seedr-sv-ss-ca-cv-ff-meta-f-fd-fu

گوگل درایو و کلون

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

/clone/cl

کاربران مجاز

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

کلون (Clone) لینک گوگل درایو را به گوگل درایو، مسیر Rclone را به مسیر Rclone دیگر (با rclone copy، یا با -sync) و لینک فایل Mega را به Mega کپی می‌کند. لینک‌های اشتراک GDToT، Filepress، Filebee، Appdrive و GDFlix اول به لینک گوگل درایو تبدیل می‌شوند. مبدأ و مقصد باید از یک نوع باشند و با یک توکن یا کانفیگ باز شوند.

با لینک پیام تلگرام (تک پیام یا بازه‌ای مثل 120-260)، پیام‌ها بدون نوشتن روی دیسک در یک یا چند چت (-ud) کپی می‌شوند و با -ct، -ex و فیلترهای regex محتوا را محدود می‌کنید. سقف تعداد پیام‌ها CLONE_TG_LIMIT است (پیش‌فرض ۱۰۰۰۰ و 0 یعنی بدون سقف).

کلون پوشهٔ Mega پشتیبانی نمی‌شود و برای Mega باید MEGA_EMAIL و MEGA_PASSWORD را در تنظیمات کاربری ثبت کرده باشید.

نمونه

/clone https://drive.google.com/drive/folders/1AbCdEfGhIjKlMnOpQrStUvWxYz012345
/cl remote:src/folder -up backup:dst -sync
/clone https://t.me/c/1234567/120-260 -ud A B -ct med -xn sample

آرگومان‌ها:-n-up-ud-rcf-gc-i-b-sync-ct-ex-mn-xn-mc-xc-fwd

/count

کاربران مجاز

حجم و تعداد فایل‌ها و زیرپوشه‌های یک لینک گوگل درایو را نشان می‌دهد.

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

نمونه

/count https://drive.google.com/drive/folders/1AbCdEfGhIjKlMnOpQrStUvWxYz012345

/del

کاربران مجاز

یک فایل یا پوشه را از گوگل درایو حذف می‌کند.

لینک گوگل درایو را کنار دستور بنویسید یا روی آن ریپلای کنید. حذف از راه API انجام می‌شود و فایل به سطل زباله نمی‌رود. اگر با سرویس‌اکانت‌ها پیدا نشود، ربات یک بار هم با token.pickle امتحان می‌کند.

دقت کنید: متن /help می‌گوید این دستور فقط برای مالک و سودوست، اما handler آن با فیلتر کاربران مجاز ثبت شده است؛ یعنی هر کاربر مجاز می‌تواند هر چیزی را که توکن ربات به آن دسترسی دارد حذف کند.

نمونه

/del https://drive.google.com/file/d/1AbCdEfGhIjKlMnOpQrStUvWxYz012345/view

/list

کاربران مجاز

در گوگل درایوها دنبال نام فایل یا پوشه می‌گردد.

بعد از /list query دکمه‌ها نمایش داده می‌شوند: User Token (جستجو در GDRIVE_ID شخصی شما به‌جای درایوهای مالک)، Recursive (جستجو در زیرپوشه‌ها) و نوع نتیجه: Folders، Files یا Both. نتایج در صفحه‌های Telegraph فهرست می‌شوند.

نمونه

/list ubuntu iso

/gdclean/gdc

کاربران مجاز

محتوای یک پوشهٔ گوگل درایو را مرور می‌کند و اجازهٔ حذف آیتم‌ها را می‌دهد.

با لینک پوشه، با -gc <category>، یا بدون آرگومان (انتخاب دسته با دکمه و سپس Start Cleaning). در صفحهٔ مرور پوشه‌ها را باز می‌کنید، بین Owner Token، My Token و Service Accounts جابه‌جا می‌شوید و هر آیتم را با دکمهٔ 🗑️ و تأیید Yes, Delete حذف می‌کنید.

این دستور هم با فیلتر کاربران مجاز ثبت شده است، پس مراقب باشید چه کسانی به ربات دسترسی دارند.

نمونه

/gdclean https://drive.google.com/drive/folders/1AbCdEfGhIjKlMnOpQrStUvWxYz012345
/gdc -gc My_Backups

آرگومان‌ها:-gc

/category/ctsel

کاربران مجاز

پوشهٔ گوگل درایو و لینک ایندکس یک تسک میرور در حال دانلود را عوض می‌کند.

تسک را با GID یا با ریپلای روی پیام دستورش مشخص کنید. تسک باید در حال دانلود، متوقف یا در صف دانلود باشد و برای لیچ کار نمی‌کند. با -id و -index مقدارها را مستقیم بدهید، وگرنه دکمه‌های دسته‌ها نمایش داده می‌شوند. فقط صاحب تسک یا سودو می‌تواند آن را تغییر دهد.

نکته: در کد این نسخه، مقدارهایی که این دستور روی تسک ذخیره می‌کند در مرحلهٔ آپلود و پیام پایانی خوانده نمی‌شوند؛ ممکن است تغییری در مقصد واقعی نبینید. برای انتخاب دسته از ابتدا، -gc را همراه دستور میرور بدهید.

نمونه

/category a1b2c3d4
/ctsel a1b2c3d4 -id 1AbCdEfGhIjKlMnOpQrStUvWxYz012345

آرگومان‌ها:-id-index

مدیریت تسک‌ها و صف

دیدن وضعیت، لغو، شروع اجباری و انتخاب فایل برای تسک‌هایی که در حال اجرا هستند.

/status/s/statusall

کاربران مجاز

وضعیت تسک‌های فعال را در پیامی که خودکار به‌روز می‌شود نشان می‌دهد.

/status me فقط تسک‌های خودتان را نشان می‌دهد و /status <user_id> تسک‌های یک کاربر مشخص را. اگر هیچ تسکی فعال نباشد، آمار کوتاهی از CPU، RAM و فضای آزاد می‌بینید. زیر هر تسک دستور /c_<GID> برای توقف و، در صورت امکان، /sel_<GID> برای انتخاب فایل آمده است.

به نام statusall پسوند CMD_SUFFIX اضافه نمی‌شود؛ پس اگر چند ربات با پسوندهای متفاوت در یک گروه باشند، این نام برای همه یکسان است.

نمونه

/status
/s me
/statusall

/cancel/c

کاربران مجاز

یک تسک را با GID آن متوقف می‌کند.

handler این دستور با regex ^/c?(?:_\w+) ثبت شده است؛ پس در عمل فقط شکل /c_<GID> کار می‌کند، همان دستوری که زیر هر تسک در پیام وضعیت آمده است. شکل‌های /cancel GID یا ریپلای /cancel با این regex جور نمی‌شوند، با اینکه متن راهنما آن‌ها را ذکر می‌کند.

اگر بعد از _ یک کد ۶ کاراکتری بیاید (مثل /c_1a2b3c که ربات برای -i و -b نشان می‌دهد)، به‌جای یک تسک، ادامهٔ آن سری چندلینکی متوقف می‌شود. فقط صاحب تسک، مالک ربات یا کاربری که با /addsudo سودو شده می‌تواند تسک را لغو کند.

نمونه

/c_a1b2c3d4
/c_1a2b3c

/cancelall/call

کاربران مجاز

چند تسک را بر اساس وضعیتشان یک‌جا لغو می‌کند.

دکمه‌ها: Downloading، Uploading، Seeding، Spltting، Cloning، Extracting، Archiving، QueuedDl، QueuedUp، SampleVideo، ConvertMedia، FFmpeg، Paused و All؛ بعد از انتخاب، با Yes! تأیید می‌کنید. کاربر عادی فقط تسک‌های خودش را لغو می‌کند؛ سودو با دکمهٔ All Added Tasks تسک‌های همهٔ کاربران را هدف می‌گیرد.

نمونه

/cancelall

/forcestart/fs

کاربران مجاز

تسکی را که در صف مانده فوراً شروع می‌کند.

/fs GID هر دو مرحله را اجباری می‌کند، /fs fd GID فقط دانلود و /fs fu GID فقط آپلود. با ریپلای روی پیام دستور تسک: /fs، /fs fd یا /fs fu.

fd یا fu را قبل از GID بنویسید. مثال /fs GID fu در راهنمای ربات، fu را نادیده می‌گیرد و هر دو مرحله را اجباری می‌کند. فقط صاحب تسک، مالک یا سودو می‌تواند از این دستور استفاده کند.

نمونه

/forcestart a1b2c3d4
/fs fu a1b2c3d4
/fs fd

/select/sel

کاربران مجاز

فایل‌های یک تورنت یا NZB در حال دانلود را برای دانلود انتخاب می‌کند.

handler با regex ^/sel?(?:_\w+) ثبت شده است، پس از شکل /sel_<GID> استفاده کنید؛ همان که در پیام وضعیت نشان داده می‌شود. دانلود متوقف می‌شود و دکمه‌ای برای صفحهٔ انتخاب فایل می‌آید؛ بعد از انتخاب، Done Selecting را بزنید.

به BASE_URL نیاز دارد و تسک باید در حال دانلود، متوقف یا در صف دانلود باشد و متادیتای آن کامل دریافت شده باشد. برای انتخاب پیش از شروع دانلود، -s را همراه دستور بدهید.

نمونه

/sel_a1b2c3d4

جستجوی تورنت و دنبال کردن خوراک‌های RSS برای دانلود خودکار.

/rss

کاربران مجاز

منوی اشتراک‌های RSS را برای دانلود خودکار باز می‌کند.

دکمه‌ها: Subscribe، Subscriptions، Get Items، Edit، Pause، Resume و Unsubscribe. سودو علاوه بر این‌ها All Subscriptions، Pause All، Resume All، Unsubscribe All، Delete User، Use This Chat و Shutdown Rss یا Start Rss را هم می‌بیند.

برای اشتراک، هر خط یک خوراک است: عنوان، لینک خوراک و آرگومان‌های اختیاری -c، -inf، -exf و -stv. خوراک‌ها هر RSS_DELAY ثانیه (پیش‌فرض ۶۰۰) بررسی و آیتم‌های جدید در RSS_CHAT فرستاده می‌شوند؛ با -c همان دستور روی لینک آیتم اجرا می‌شود. بدون RSS_CHAT زمان‌بند RSS خاموش می‌ماند و DISABLE_RSS کل این دستور را غیرفعال می‌کند.

نمونه

/rss
Title https://example.com/feed.xml -c mirror -up remote:rss -inf 1080|mkv -exf cam

آرگومان‌ها:-c-inf-exf-stv

تنظیمات

تنظیمات شخصی هر کاربر و تنظیمات کلی ربات، هر دو با منوی دکمه‌ای داخل تلگرام.

/usetting/us

کاربران مجاز

منوی تنظیمات شخصی شما را باز می‌کند.

بخش‌ها: General Settings، Mirror Settings، Leech Settings، Uphoster Settings، FF Media Settings، Clone Settings، YT-DLP Settings و Misc Settings، به‌علاوهٔ Export و Import برای انتقال تنظیمات با عبارت عبور. مقدارهایی که اینجا تنظیم می‌کنید برای تسک‌های خودتان بر متغیرهای مالک مقدم‌اند.

فیلتر این دستور authorized_uset است: کاربران مجاز را می‌پذیرد و در چت خصوصی، عضویت در کانال‌هایی را هم بررسی می‌کند که در داده‌های ربات با is_auth علامت خورده‌اند. توضیح همهٔ گزینه‌ها در تنظیمات کاربری.

نمونه

/usetting

/bsetting/bs

سودو و مالک

تنظیمات کلی ربات را از داخل تلگرام ویرایش می‌کند.

بخش‌ها: Config Variables، Module Settings، Private Files، Qbit Settings، Aria2c Settings، Sabnzbd Settings و JDownloader Sync. در Module Settings با On/Off Settings ماژول‌ها (متغیرهای DISABLE_*) را روشن و خاموش و با Limit Settings سقف‌ها را تنظیم می‌کنید.

توضیح کامل در تنظیمات ربات و فهرست متغیرها در مرجع متغیرها.

نمونه

/bsetting

/lockmysession/lms

کاربران مجاز

کلید باز کردن استرینگ سشن شخصی شما را از حافظهٔ ربات پاک می‌کند.

اگر در /usetting بخش Clone Settings با دکمهٔ User Session استرینگ سشن شخصی (USER_SESSION) ذخیره کرده باشید، ربات فقط نسخهٔ رمزشدهٔ آن را نگه می‌دارد. بعد از اینکه یک بار با عبارت عبورتان بازش کنید، کلید تا USER_SESSION_KEY_TTL ثانیه (پیش‌فرض ۴۳۲۰۰، یعنی ۱۲ ساعت) در حافظه می‌ماند.

این دستور کلید را فوراً پاک می‌کند. تسک‌هایی که در حال اجرا هستند تمام می‌شوند و برای استفادهٔ بعدی باید دوباره عبارت عبور را وارد کنید.

نمونه

/lockmysession

رسانه و گالری

لینک پخش آنلاین برای فایل‌های تلگرام و مدیریت تصاویری که ربات کنار پیام‌هایش نشان می‌دهد.

/stream/sl

کاربران مجاز

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

روی یک فایل ریپلای کنید یا لینک پیام تلگرام (یا بازه‌ای مثل https://t.me/c/1234567/100-150) بدهید. ربات برای هر فایل دکمه‌های Stream و Download می‌سازد که روی وب‌سرور ربات (BASE_URL) باز می‌شوند.

گزینه‌های این دستور مخصوص خودش هستند و ربطی به آرگومان‌های /mirror ندارند: -pl (یا -playlist) همهٔ فایل‌ها را در یک صفحهٔ پلی‌لیست می‌گذارد؛ -m (یا -merge) تکه‌های یک ویدیو را پشت سر هم روی یک خط زمانی پخش می‌کند؛ -t (یا -thumb) با لینک یک عکس، تصویر کاور می‌گذارد؛ -ttl (یا -expire) با مقداری مثل 1d2h3m لینک‌ها را خودانقضا می‌کند؛ و -d (یا -del و -delete) همراه لینک پخش یا پلی‌لیست، آن را حذف می‌کند (فقط مالک یا سودو). برای -pl و -m می‌توانید پیش از لینک یک نام هم بنویسید.

به BASE_URL و دست‌کم یکی از STREAM_TOKENS یا HELPER_TOKENS نیاز دارد. اگر DISABLE_STREAM فعال باشد، دستور ثبت است ولی پیام غیرفعال بودن می‌دهد و در منوی دستورهای ربات دیده نمی‌شود.

نمونه

/stream <reply to a video>
/sl https://t.me/c/1234567/100-110 -pl My Series
/stream -m Movie https://t.me/c/1234567/200-203
/stream https://t.me/c/1234567/42 -ttl 1d
/stream https://stream.example.com/xstrm/abc123 -d

/addimage/ai

کاربران مجاز

یک عکس به گالری تصاویر ربات (IMAGES) اضافه می‌کند.

روی یک عکس ریپلای کنید، یا لینکی که با http شروع می‌شود را کنار دستور بنویسید یا رویش ریپلای کنید. ربات این تصاویر را کنار پیام‌هایی مثل /start، /stats و /count نشان می‌دهد. اگر DATABASE_URL تنظیم شده باشد، فهرست ذخیره می‌شود.

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

نمونه

/addimage <reply to a photo>
/ai https://example.com/banner.jpg

/images/img

کاربران مجاز

گالری تصاویر ربات را با امکان ورق زدن و حذف نشان می‌دهد.

دکمه‌ها: « و » برای جابه‌جایی، Remove Image، Remove All و Close. هر کاربر مجاز می‌تواند گالری را باز کند و فقط کسی که منو را باز کرده با دکمه‌هایش کار می‌کند.

نمونه

/images

مدیریت ربات

مجاز کردن چت‌ها، مدیریت سودوها و محرومیت‌ها، ارسال همگانی، ری‌استارت، لاگ و افزونه‌ها. این دستورها مخصوص کاربر سودو و مالک ربات هستند.

/authorize/a

سودو و مالک

یک چت، تاپیک یا کاربر را مجاز می‌کند.

بدون آرگومان، همان چت (یا تاپیکی که دستور در آن فرستاده شده) مجاز می‌شود؛ با ریپلای روی پیام یک کاربر، همان کاربر؛ و با /authorize -1001234567890 یا /authorize -1001234567890|5 یک چت یا تاپیک مشخص. این مجوزها در پایگاه داده ذخیره می‌شوند و از AUTHORIZED_CHATS پیکربندی جدا هستند.

نمونه

/authorize
/a -1001234567890|5

/unauthorize/ua

سودو و مالک

مجوز یک چت، تاپیک یا کاربر را برمی‌دارد.

ورودی‌ها مثل /authorize است. اگر آخرین تاپیک مجاز یک چت را بردارید، خود چت هم از حالت مجاز خارج می‌شود. چت‌هایی که از AUTHORIZED_CHATS آمده‌اند با این دستور حذف نمی‌شوند.

نمونه

/unauthorize
/ua -1001234567890

/addsudo/as

سودو و مالک

یک کاربر را کاربر سودو می‌کند.

شناسهٔ عددی کاربر را بدهید یا روی پیامش ریپلای کنید. متن /help می‌گوید فقط مالک، اما handler با فیلتر سودو ثبت شده است؛ یعنی هر سودو می‌تواند سودوی جدید اضافه کند.

نمونه

/addsudo 123456789
/as <reply to a user>

/rmsudo/rs

سودو و مالک

دسترسی سودوی یک کاربر را برمی‌دارد.

با شناسه یا ریپلای. سودوهایی که از SUDO_USERS پیکربندی آمده‌اند با این دستور حذف نمی‌شوند و باید از خود پیکربندی برداشته شوند. متن /help این دستور را فقط برای مالک می‌داند، اما handler با فیلتر سودو ثبت شده است.

نمونه

/rmsudo 123456789

/blacklist/bl

سودو و مالک

یک کاربر را برای همیشه یا موقت از استفاده از ربات محروم می‌کند.

/bl 123456789 محرومیت دائمی است و /bl 123456789 -t 1d موقت؛ با ریپلای: /bl -t 2h. واحدهای زمان d، h و m هستند. در این دستور -t مدت محرومیت است، نه تامبنیل.

کاربر محروم برای هر دستوری که با / شروع شود پیام BlackListed Detected می‌گیرد. محرومیت موقت بعد از پایان زمان خودکار برداشته می‌شود.

نمونه

/blacklist 123456789
/bl 123456789 -t 3d
/bl -t 12h

/rmblacklist/rbl

سودو و مالک

محرومیت یک کاربر را برمی‌دارد.

با شناسهٔ عددی یا ریپلای روی پیام کاربر.

نمونه

/rmblacklist 123456789

/users

سودو و مالک

داده‌های ذخیره‌شدهٔ همهٔ کاربران و چت‌ها را نشان می‌دهد.

چت‌های AUTHORIZED_CHATS، کاربران SUDO_USERS و تنظیمات ذخیره‌شدهٔ هر کاربر (به‌جز چند کلید حساس) فهرست می‌شوند. اگر متن طولانی باشد، به‌صورت فایل users_settings.txt فرستاده می‌شود.

نمونه

/users

/broadcast/bc

سودو و مالک

پیامی را برای همهٔ کسانی که ربات را در چت خصوصی استارت کرده‌اند می‌فرستد.

روی پیام موردنظر ریپلای کنید و /broadcast بفرستید. گزینه‌های این دستور مخصوص خودش هستند: -f (یا -forward) به‌جای کپی فوروارد می‌کند و -q (یا -quiet) بی‌صدا می‌فرستد.

در پایان یک Broadcast ID می‌گیرید: /bc <id> -d (یا -delete) پیام‌های فرستاده‌شده را حذف می‌کند و با ریپلای روی نسخهٔ ویرایش‌شده، /bc <id> -e (یا -edit) آن‌ها را ویرایش می‌کند. این شناسه‌ها فقط تا ری‌استارت بعدی معتبرند و پیام‌های فورواردشده قابل ویرایش نیستند. به DATABASE_URL نیاز دارد.

نمونه

/broadcast <reply to a message> -q
/bc a1b2c3d4e5 -d
/bc a1b2c3d4e5 -e <reply to the edited message>

/restart/r/restartall

سودو و مالک

ربات را ری‌استارت می‌کند.

بعد از تأیید با Yes!، در حالت عادی همهٔ تسک‌ها متوقف و دانلودهای qBittorrent، Aria2، SABnzbd و JDownloader پاک می‌شوند، update.py اجرا می‌شود (اگر UPSTREAM_REPO تنظیم شده باشد، کد را به‌روز می‌کند) و پردازهٔ ربات از نو اجرا می‌شود.

/restart -s ری‌استارت نرم است: update.py اجرا و کد ماژول‌ها دوباره بارگذاری می‌شود، اما تسک‌ها ادامه پیدا می‌کنند. به نام restartall پسوند CMD_SUFFIX اضافه نمی‌شود.

نمونه

/restart
/r -s
/restartall

/restartses/rses

سودو و مالک

کلاینت‌های تلگرام ربات را دوباره راه‌اندازی می‌کند.

بعد از تأیید با Yes!، کلاینت ربات، حساب کاربری و ربات‌های کمکی دوباره وصل می‌شوند و handlerها از نو ثبت می‌شوند، بدون اینکه کل پردازه ری‌استارت شود.

نمونه

/restartses

/log

سودو و مالک

فایل log.txt ربات را می‌فرستد.

دکمهٔ Log Disp آخرین خطوط لاگ را در خود تلگرام نشان می‌دهد و Web Log کل لاگ را در spaceb.in قرار می‌دهد و لینکش را می‌سازد. لاگ شامل لینک‌ها و شناسه‌های کاربران است؛ پیش از اشتراک‌گذاری لینک Web Log به این توجه کنید.

نمونه

/log

/memory/mem

سودو و مالک

مصرف حافظه، کش‌ها و پروفایلر تخصیص حافظه را نشان می‌دهد.

دکمه‌ها: Refresh، Breakdown، Start Profiler یا Stop Profiler، Top Allocations (وقتی پروفایلر روشن است) و Free Memory. وقتی فشار حافظه بالا باشد، ربات کش‌ها را خودکار کوچک می‌کند.

نمونه

/memory

/plugins

سودو و مالک

افزونه‌ها را مدیریت می‌کند: مرور، نصب، فعال یا غیرفعال کردن و حذف.

منو شامل Installed (افزونه‌های نصب‌شده)، Marketplace و Install است؛ نصب از فایل zip یا از GitHub (owner/repo یا owner/repo@branch) انجام می‌شود. سودوها فقط مرور و نصب می‌کنند؛ فعال یا غیرفعال کردن، حذف، به‌روزرسانی و تغییر تنظیمات افزونه‌ها فقط کار مالک ربات است.

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

نمونه

/plugins

ابزارهای سرور و توسعه

اجرای مستقیم دستور shell و کد پایتون روی سرور ربات. این دستورها دسترسی کامل به سرور می‌دهند.

/shell

سودو و مالک

یک دستور shell روی سرور ربات اجرا می‌کند.

خروجی stdout و stderr برگردانده می‌شود و اگر طولانی باشد، به‌صورت فایل shell_output.txt. handler پیام جدید برای سودوها ثبت شده و اجرای دوباره با ویرایش پیام فقط برای مالک. متن /help این دستور را فقط برای مالک می‌داند. این دستور دسترسی کامل به سرور می‌دهد.

نمونه

/shell df -h
/shell ls downloads

/aexec

سودو و مالک

کد پایتون async را داخل پردازهٔ ربات اجرا می‌کند.

متغیرها در فضای نام جداگانهٔ هر چت نگه داشته می‌شوند تا در اجراهای بعدی در دسترس باشند و /clearlocals پاکشان می‌کند. خروجی طولانی به‌صورت فایل output.txt فرستاده می‌شود. متن /help می‌گوید فقط مالک، اما handler با فیلتر سودو ثبت شده است.

نمونه

/aexec return len(user_data)

/exec

سودو و مالک

کد پایتون همگام (sync) را داخل پردازهٔ ربات اجرا می‌کند.

مثل /aexec برای کد غیر async است و از همان فضای نام هر چت استفاده می‌کند. متن /help می‌گوید فقط مالک، اما handler با فیلتر سودو ثبت شده است.

نمونه

/exec print('hello')

/clearlocals

سودو و مالک

متغیرهای ذخیره‌شدهٔ /exec و /aexec را برای این چت پاک می‌کند.

بعد از آن، اجرای بعدی /exec یا /aexec با فضای نام تازه شروع می‌شود.

نمونه

/clearlocals

افزونه‌های همراه

دستورهایی که افزونه‌های همراه ربات (پوشهٔ plugins/) اضافه می‌کنند. همه به‌طور پیش‌فرض فعال‌اند و مالک می‌تواند هرکدام را از /plugins غیرفعال کند.

/anime/anilist

کاربران مجازپلاگین anilist

در AniList با نام یا شناسه دنبال انیمه می‌گردد.

از افزونهٔ همراه anilist می‌آید. نتیجه با دکمه‌هایی برای بخش‌های مختلف اطلاعات نمایش داده می‌شود. قالب کپشن و طول خلاصهٔ داستان در تنظیمات افزونه (از /plugins) قابل تغییر است.

نمونه

/anime one piece
/anilist 21

/character

کاربران مجازپلاگین anilist

در AniList دنبال یک شخصیت می‌گردد.

از افزونهٔ همراه anilist می‌آید.

نمونه

/character character name

/manga

کاربران مجازپلاگین anilist

در AniList دنبال مانگا می‌گردد.

از افزونهٔ همراه anilist می‌آید.

نمونه

/manga manga name

/animehelp

کاربران مجازپلاگین anilist

راهنمای دستورهای افزونهٔ AniList را نشان می‌دهد.

از افزونهٔ همراه anilist می‌آید.

نمونه

/animehelp

/exportsession

سودو و مالکپلاگین gen_pyro_sess

قدم‌به‌قدم یک استرینگ سشن Pyrogram می‌سازد.

از افزونهٔ همراه gen_pyro_sess می‌آید و فقط در چت خصوصی با ربات کار می‌کند؛ در گروه پاسخی نمی‌دهد. اگر TELEGRAM_API و TELEGRAM_HASH در پیکربندی باشند از همان‌ها استفاده می‌شود، وگرنه ربات API_ID و API_HASH را می‌پرسد. بعد شماره تلفن، کد ورود و در صورت وجود رمز دومرحله‌ای را می‌گیرد و استرینگ سشن را در Saved Messages همان حساب می‌فرستد.

خروجی را می‌توانید برای USER_SESSION_STRING یا استرینگ سشن شخصی در /usetting استفاده کنید.

نمونه

/exportsession

/imdb

کاربران مجازپلاگین imdb

در IMDb دنبال فیلم یا سریال می‌گردد و کارت اطلاعات آن را می‌فرستد.

از افزونهٔ همراه imdb می‌آید. با نام، یا با شناسهٔ IMDb (tt و عدد) جستجو کنید؛ نتایج به‌صورت دکمه نشان داده می‌شوند و با انتخاب هرکدام، کارت اطلاعات فرستاده می‌شود.

نمونه

/imdb movie name
/imdb tt0000001

/mediainfo/mi

کاربران مجازپلاگین mediainfo

اطلاعات فنی (MediaInfo) یک فایل رسانه‌ای یا لینک مستقیم را نشان می‌دهد.

از افزونهٔ همراه mediainfo می‌آید. روی ویدیو، صدا، سند یا انیمیشن ریپلای کنید، یا لینک مستقیم بدهید؛ خروجی در یک صفحهٔ Telegraph منتشر می‌شود.

نمونه

/mediainfo <reply to a video>
/mi https://example.com/video.mkv

/mdl/mydramalist

کاربران مجازپلاگین mydramalist

در MyDramaList دنبال سریال یا فیلم می‌گردد.

از افزونهٔ همراه mydramalist می‌آید. نتایج به‌صورت دکمه نشان داده می‌شوند (پیش‌فرض ۸ نتیجه) و تعداد نتایج، قالب کپشن و طول خلاصه در تنظیمات افزونه قابل تغییر است.

نمونه

/mdl drama name

/nzbsearch/ns

کاربران مجازپلاگین nzb_search

در ایندکسرهای Usenet از طریق NZBHydra جستجو می‌کند.

از افزونهٔ همراه nzb_search می‌آید و به HYDRA_IP و HYDRA_API_KEY نیاز دارد. اگر DISABLE_NZB فعال باشد (که پیش‌فرض است)، پیام غیرفعال بودن SABnzbd را می‌دهد. نتایج در صفحهٔ Telegraph با دکمهٔ Results نمایش داده می‌شوند.

نام کوتاه /ns را با آرگومان -ns (جایگزینی در نام) اشتباه نگیرید.

نمونه

/nzbsearch ubuntu iso
/ns ubuntu iso

/speedtest/spt

کاربران مجازپلاگین speedtest

سرعت شبکهٔ سرور ربات را اندازه می‌گیرد.

از افزونهٔ همراه speedtest می‌آید و با speedtest-cli نزدیک‌ترین سرور را پیدا می‌کند و سرعت دانلود و آپلود را می‌سنجد.

نمونه

/speedtest

مثلاً LEECH_SPLIT_SIZE، /mirror، -up یا «تامبنیل»