Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎬 ربات دانلودر یوتیوب و اینستاگرام YouDL

یک ربات پیشرفته و بسیار سریع تلگرامی برای دانلود ویدئو، صدا، زیرنویس و استوری از یوتیوب و اینستاگرام با قابلیت‌های بی‌نظیر.

🤖 مشاهده ربات در تلگرام📄 مشاهده نسخه انگلیسی🌐 وب‌سایت پروژه


✨ ویژگی‌های کلیدی

  • 🚀 دانلود سریع و هوشمند: ارسال مستقیم لینک برای دانلود فوری با بهترین کیفیت متوسط.
  • ⚙️ حالت پیشرفته: انتخاب دستی کیفیت ویدئو و صدا، پشتیبانی از تمام رزولوشن‌ها.
  • 💬 زیرنویس (هاردساب): قابلیت دانلود و تایید (Burn) زیرنویس روی ویدئو به بیش از ۱۵ زبان زنده دنیا.
  • ⏱️ برش زمانی: برش دقیق ویدئو یا صدا بر اساس بازه زمانی دلخواه (مثلاً از دقیقه ۱ تا ۲:۳۰).
  • 📊 نوار پیشرفت زنده: نمایش دقیق درصد دانلود، سرعت، حجم و زمان باقی‌مانده به صورت لحظه‌ای.
  • 📦 مدیریت فایل‌های حجیم: پشتیبانی از فایل‌های بالای ۵۰ مگابایت تا ۲ گیگابایت (با تلگرون) و فشرده‌سازی خودکار به RAR برای فایل‌های بالاتر از ۲ گیگابایت با قابلیت پارت‌بندی.
  • 🛑 لغو عملیات: دکمه اختصاصی برای توقف دانلود در هر لحظه و پاکسازی خودکار فایل‌های موقت.
  • 🔐 پشتیبانی از کوکی: استفاده از کوکی برای دور زدن محدودیت‌های یوتیوب (مانند ویدئوهای ۱۸+) و اینستاگرام.
  • 🛡️ اجباری به عضویت: قابلیت بررسی عضویت کاربر در کانال قبل از اجازه استفاده از ربات.

🛠️ پیش‌نیازها

برای اجرای ربات باید نرم‌افزارها و کتابخانه‌های زیر روی سرور شما نصب باشد:

  • Python 3.8 یا بالاتر
  • FFmpeg
  • Deno (برای اجرای کامپوننت‌های جاوااسکریپت yt-dlp)
  • yt-dlp , yt-dlp-ejs , gallery-dl , instaloader , telethon , python-telegram-bot
  • RAR (برای فشرده‌سازی فایل‌های بالای ۲ گیگابایت)

💡 نکته: برای راحتی کار، اسکریپت install.sh را اجرا کنید تا تمام این پیش‌نیازها به صورت خودکار نصب شوند!

⚡ نصب و راه‌اندازی سریع (توصیه شده)

بهترین راه برای نصب، استفاده از اسکریپت آماده زیر است. این اسکریپت ریپو را کلون کرده، زیپ را باز کرده و تمام پیش‌نیازها را نصب می‌کند:

bash <(curl -sL https://raw.githubusercontent.com/itsalics/YouDL-Bot/main/install.sh)

یا فایل را دستی دانلود کرده و اجرا کنید: chmod +x install.sh && ./install.sh

📝 تنظیمات دستی

پس از نصب پیش‌نیازها و قبل از اجرای ربات، باید تنظیمات زیر را در فایل downloader.py انجام دهید:

۱. تنظیم متغیرهای تلگرام

متغیرهای زیر را در ابتدای فایل پایتون پیدا کرده و مقادیر واقعی را جایگزین کنید:

TOKEN = "توکن_ربات_شما" # از @BotFather دریافت کنید
API_ID = 12345678 # از https://my.telegram.org/ دریافت کنید
API_HASH = "هش_شما" # از https://my.telegram.org/ دریافت کنید
CHANNEL_USERNAME = "آیدی_کانال_شما"
CHANNEL_ID = -1001234567890 # آیدی عددی کانال
SPONSOR_CHANNEL = "آیدی_کانال_اسپانسر"

⚠️ توجه: برای عملکرد صحیح عضویت اجباری در کانال، باید ربات در کانالی که آیدی آن در متغیر CHANNEL_USERNAME تنظیم شده ادمین باشد تا بتواند عضویت کاربر ها را در کانال بررسی کند.

۲. فراهم کردن کوکی‌ها (بسیار مهم)

برای دانلود بدون مشکل از یوتیوب و اینستاگرام (به خصوص برای ویدئوهای محدود شده یا-private)، باید کوکی مرورگر خود را وارد کنید.

🔴 برای یوتیوب (فایل cookies.txt):

  1. افزونه Get cookies.txt LOCALLY را روی کروم نصب کنید: لینک افزونه
  2. وارد حساب کاربری یوتیوب خود در مرورگر شوید.
  3. روی آیکون افزونه کلیک کرده و دکمه Export As را بزنید تا فایل cookies.txt دانلود شود.
  4. این فایل را دقیقاً در کنار فایل downloader.py آپلود کنید.

🟡 برای اینستاگرام (فایل ig_cookies.txt):

  1. از همین افزونه استفاده کنید.
  2. وارد حساب اینستاگرام خود شوید.
  3. با کلیک روی Export As کوکی‌ها را خروجی بگیرید.
  4. نام فایل را به ig_cookies.txt تغییر دهید و آن را دقیقاً در کنار فایل downloader.py قرار دهید.

⚠️ توجه: نام و محل قرارگیری فایل‌های کوکی بسیار مهم است. فایل یوتیوب حتماً باید cookies.txt و فایل اینستاگرام حتماً باید ig_cookies.txt نام داشته باشند و در همان پوشه‌ای باشند که کد پایتون قرار دارد.

🚀 اجرای ربات

پس از انجام تمام مراحل بالا، ربات را با دستور زیر اجرا کنید:

python3 downloader.py

برای اجرای ربات در پس‌زمینه و روشن ماندن دائمی آن، پیشنهاد می‌کنیم از screen یا tmux استفاده کنید:

screen -S YouDL
python3 downloader.py
# با زدن Ctrl+A و سپس D از اسکرین خارج شوید.

🤝 روش استفاده در تلگرام

  • حالت سریع: فقط لینک یوتیوب یا اینستاگرام را بفرستید تا بهترین کیفیت ارسال شود.
  • حالت پیشرفته: دستور /download را بفرستید، سپس لینک را ارسال کنید تا منوی انتخاب کیفیت، زیرنویس و برش زمان باز شود.

🛡️ تکنولوژی‌های استفاده شده

  • python-telegram-bot & Telethon برای ارتباط با API تلگرام
  • yt-dlp & yt-dlp-ejs برای استخراج و دور زدن محدودیت‌های جاوااسکریپت یوتیوب
  • instaloader & gallery-dl برای دانلود از اینستاگرام
  • FFmpeg برای پردازش، برش، هاردساب و ترکیب صدا/تصویر

Developed with ❤️ By ༺𝑨𝒍𝒊™ 𝑳𝒊𝒏𝒖𝒙 𝑪𝑺༻

🤖 ربات آماده استفاده: @AliTMYOUtube_downloader_bot

About

YouDL - A feature rich TG Bot for downloading photos and videos from YouTube & Instagram.

Topics

Resources

Stars

17 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages