ابزاری قدرتمند برای دانلود فایلها، صفحات وب و ویدیوهای یوتیوب با استفاده از قابلیت GitHub Actions
با این مخزن میتوانید به کمک GitHub Actions هر فایلی که روی اینترنت ملی ایران به آن دسترسی ندارید را به سادگی دانلود کنید. کافیست ریپازیتوری را فورک کنید و از طریق تب Actions، عملیات دانلود خود را آغاز کنید.
این پروژه، نسخهای شخصیسازیشده از مخزن nikzad-avasam/downloader است که با سپاس از نیکزاد آواسام، نویسنده اصلی آن، تهیه شده است.
- ⬇️ دانلود فایل از لینک مستقیم: دریافت هر نوع فایل با پشتیبانی از لینکهای مستقیم
- 🌐 ذخیره کامل یک صفحه وب: دریافت فایل HTML، اسکرینشات، استخراج تمام لینکها و دانلود خودکار فایلهای رسانهای (تصاویر، ویدیوها، آهنگها و مستندات)
- 🎬 دانلود ویدیو از یوتیوب: قابلیت انتخاب کیفیت (بهترین کیفیت، ۴K، ۱۰۸۰p، ۷۲۰p، ۴۸۰p و فقط صوت)
و البته:
- 🔐 رمزگذاری فایلهای ZIP
- 🧹 تمیزکننده خودکار حجم مخزن: دیگر نگران بزرگ شدن حجم ریپازیتوری نباشید! (با استفاده از
workflow cleaner)
- فورک کردن: روی دکمه Fork در بالای صفحه کلیک کنید تا یک کپی از مخزن در اکانت خود بسازید.
- انتخاب عملیات: به تب Actions در ریپازیتوری فورک شده بروید.
- اجرای دانلود: از لیست
workflowها (ستون سمت چپ)، action مورد نظر خود را انتخاب کنید:01- Download from url: برای دانلود فایل با لینک مستقیم04- Browse the Web: برای ذخیره یک صفحه وب05- Youtube Downloader - small files: برای دانلود ویدیوهای یوتیوب (حجم کمتر از ۲GB)
- ورود اطلاعات: روی دکمه Run workflow کلیک کنید و اطلاعات درخواستی (مانند لینک، کیفیت و رمز دلخواه) را وارد کنید.
- دریافت خروجی: پس از اتمام اجرا، فایلهای دانلود شده در شاخههای مربوطه (
downloads،pagesوvideos) در ریپازیتوری شما ذخیره میشوند. برای دریافت فایلها، ریپو را روی سیستم خودpullکنید یا فایلها را مستقیماً از روی گیتهاب دانلود نمایید.
پس از اجرای هر اکشن، خروجی در پوشههای زیر ذخیره میشود:
| ناحیه | توضیحات |
|---|---|
🗂️ downloads/ |
فایلهای دانلود شده از لینک مستقیم در این مسیر ذخیره میشوند (اکشن شماره ۱). |
🗂️ pages/ |
پس از اجرای اکشن مرورگر (شماره ۴)، صفحه کامل در پوشهای بر اساس دامنه و اسلاگ آدرس، به همراه screenshot.png، all_links.txt و یک زیرپوشه media/ شامل فایلهای رسانهای آن صفحه، ذخیره میشود. |
🗂️ videos/ |
ویدیوهای دانلود شده از یوتیوب (اکشنهای ۵ و ۶) در این مسیر قرار میگیرند. |
- حجم مخزن: برای جلوگیری از افزایش بیرویه حجم ریپو، حتماً هر از چند گاهی
workflow cleanerرا اجرا کنید. این اکشن تاریخچه کامیتهای حجیم را پاک خواهد کرد. - محدودیت GitHub: توجه داشته باشید که GitHub Actions برای هر اجرا محدودیت ۶ ساعته و همچنین محدودیت حجم برای آپلود Artifact دارد.
- عدم دسترسی به برخی سرورها: برخی از سرورهای ایرانی (مانند soft98) آیپی خارج را مسدود کردهاند؛ بنابراین ممکن است دانلود از آنها با این ابزار موفقیتآمیز نباشد.
- مشکل در صفحات وب: متأسفانه برخی سایتها، محتوای خود را به صورت داینامیک و با جاوااسکریپت لود میکنند. اکشن مرورگر (
04-browser.yml) ممکن است در ذخیره کامل این صفحات موفق نباشد.
برای پاکسازی خودکار تاریخچه کامیتها و جلوگیری از بزرگ شدن ریپازیتوری، workflow cleaner را به صورت دورهای اجرا کنید. این کار از بروز مشکل در حین push یا pull کردن مخزن جلوگیری میکند.
این پروژه تحت مجوز MIT منتشر شده است.❤️ با تشکر از نیکزاد آواسام به خاطر ایده اولیه و زحماتشان. لطفاً در صورت تمایل، حتماً به ریپازیتوری اصلی ایشان سر بزنید.