Skip to content

fndrmh/YouTubeDownloader

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 

Repository files navigation

🎯 YouTube Downloader

دانلود مستقیم ویدیو و صدا از یوتیوب در گیت‌هاب — بدون نصب هیچ نرم‌افزاری


📖 فهرست


✨ امکانات

  • 🎬 ۴ حالت دانلود: تک‌ویدیو، پلی‌لیست، کانال و جستجو
  • 🎵 فرمت خروجی: MP4 برای ویدیو یا MP3 برای صدا، با کیفیت دلخواه
  • 📊 ایندکس خودکار: تولید فایل Markdown شامل ریز اطلاعات تمام ویدیوها
  • 🛜️ تصاویر ویدیو ها (Thumbnail): دریافت خودکار برای هر ویدیو
  • ✂️ تقسیم هوشمند فایل: اگر حجم خروجی از حد مجاز رد شود، خودکار تکه‌تکه می‌شود
  • 💯 کاملاً رایگان: بدون نیاز به هیچ کلید API یا ثبت‌نام اضافه


📘 راهنمای گام‌به‌گام

۱. لاگین در گیت‌هاب

  • وارد سایت GitHub بشید.
  • اگر حساب کاربری ندارید، اول ثبت‌نام کنید.
  • بعد با اکانت خودتون لاگین کنید.

🔐 لاگین بودن خیلی مهمه، چون بقیه مراحل فقط وقتی انجام می‌شه که وارد حساب خودتون باشید.


۲. فورک پروژه

با این کار یک نسخهٔ شخصی از پروژه در اکانت خودتان می‌سازید:

  1. به صفحهٔ اصلی پروژه در گیت‌هاب بروید.
  2. روی دکمهٔ Fork (بالا-راست) کلیک کنید.
  3. یک نام دلخواه برای مخزن جدیدتان انتخاب کنید.
  4. روی Create fork بزنید.

۳. تنظیم مجوزها

⚠️ این مرحله حیاتی است. بدون آن، فایلی روی مخزن شما ذخیره نخواهد شد.

  • به مخزن فورک‌شده بروید.
  • وارد Settings > Actions > General شوید.
  • در بخش Workflow permissions، گزینهٔ Read and write permissions را فعال کرده و Save کنید.

۴. فعال‌سازی Actions

وقتی پروژه‌ای را فورک می‌کنید، Actions آن معمولاً غیرفعال است.

  • به تب Actions در مخزن خود بروید.
  • روی دکمهٔ "I understand my workflows, go ahead and enable them" کلیک کنید.

۵. اجرای دانلودر

  1. در تب Actions، روی نام 🎯 YouTube Downloader در نوار کناری کلیک کنید.
  2. دکمهٔ Run workflow را بزنید.
  3. فرم ظاهر شده را این‌گونه پر کنید:
فیلد توضیح مثال
🔄 Download Mode یکی از حالت‌های single, playlist, channel, search single
🎬 URL or Search Query لینک ویدیو/پلی‌لیست/کانال یا عبارت جستجو https://youtu.be/...
📦 Output Type video یا audio video
🎚️ Quality کیفیت خروجی (مثلاً 720 برای ویدیو) 720
🔢 Max results حداکثر تعداد نتایج (برای پلی‌لیست، کانال و جستجو) 10
📦 Split > MB تقسیم فایل‌های بزرگ‌تر از این حجم (۰ = بدون تقسیم) 50
  1. روی Run workflow کلیک کنید و منتظر بمانید تا فرآیند تکمیل شود.

🎮 حالت‌های دانلود

۱. تک‌ویدیو (single)

دانلود یک ویدیو یا صدای ویدیو .

۲. پلی‌لیست (playlist)

دانلود تمام ویدیوهای یک لیست پخش.
امکانات اضافه:

  • ساخت فایل ایندکس کامل (Index.md) با ریز جزئیات
  • فایل info جداگانه برای هر ویدیو

۳. کانال (channel)

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

  • لینک کامل کانال
  • @ChannelName
  • یا فقط نام کانال

۴. جستجو (search)

جستجوی یک عبارت و ذخیره‌سازی فهرست نتایج در یک فایل Markdown.

توجه: در این حالت خود ویدیوها دانلود نمی‌شوند و تنها اطلاعات آن‌ها ذخیره می‌گردد.


⚙️ تنظیمات پیشرفته

🎚️ کیفیت

فرمت خروجی کیفیت‌های پشتیبانی‌شده
ویدیو (MP4) 144, 360, 480, 720, 1080
صدا (MP3) 128, 192, 320

✂️ تقسیم (Split Threshold)

مقدار عددی نتیجه
0 فایل هرگز تقسیم نمی‌شود
50 فایل‌های بزرگ‌تر از ۵۰ مگابایت به بخش‌های ۵۰MB تقسیم می‌شوند
90 آستانهٔ تقسیم روی ۹۰ مگابایت تنظیم می‌شود

🔢 حداکثر نتایج (Max Results)

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


🧩 مدیریت فایل‌های چندبخشی (Split)

اگر حجم یک فایل از حد تعیین‌شده عبور کند، به چند بخش فشرده تبدیل می‌شود:

video.mp4.zip
video.mp4.z01
video.mp4.z02
video.mp4.z03

نحوه استخراج:

  • ویندوز: تمامی بخش‌ها را در یک پوشه قرار دهید، روی فایل .zip راست‌کلیک کرده و گزینهٔ Extract All... را انتخاب کنید.

☕ حمایت از پروژه

اگر این پروژه به کارتان آمده و مایلید از توسعه‌دهنده حمایت کنید:
🔗 daramet.com/Tavakoli

برای اطلاع از بروزرسانی‌ها:
📎 ble.ir/alitavakoli01


About

دانلود از یوتیوب با نت ملی

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors