All‑in‑One GitHub Actions Downloader — بدون فیلتر · بدون تحریم
⭐ اگر این پروژه برایتان مفید است، لطفاً ستاره بدهید — به دیگران کمک میکند پیدایش کنند! ⭐
پیش از هر چیز: این مخزن را فورک کردهاید؟ حتماً ابتدا پاککننده جامع (AIO Cleaner) را اجرا کنید تا تمام فایلهای باقیمانده از مخزن اصلی (شامل بایگانی و رسانههای تلگرام) از بین بروند و شما از صفر شروع کنید. (توضیحات کامل در بخش ۸)
- پیشنیازها
- فورک و راهاندازی اولیه
- نحوه استخراج و افزودن کوکیها
- راهنمای کامل هر گردش کار
- محدودیتها و هشدارهای مهم
- فایل zoomusers.md چیست؟
| نیاز | توضیح |
|---|---|
| 🟢 حساب GitHub | رایگان — همین کافیست |
| 🟠 مرورگر + افزونه Get cookies.txt LOCALLY | Chrome / Firefox / Edge |
| 🔵 حساب اینستاگرام | (اختیاری) برای استوری و محتوای خصوصی |
| 🔴 حساب X (توییتر) | الزامی برای دانلودر X |
| 🟢 تلگرام، ضبط وبسایت، و گوگل پلی | هیچ چیز اضافی نیاز ندارند |
روی دکمه Fork در بالای صفحه کلیک کنید.
- به مخزن فورکشده بروید → Settings → Actions → General
- در بخش Actions permissions گزینه Allow all actions and reusable workflows را انتخاب کنید
- روی Save کلیک کنید
- همان مسیر → Workflow permissions
- گزینه Read and write permissions را انتخاب کنید
- روی Save کلیک کنید
⚠️ اگر این مرحله را انجام ندهید، تمام گردشکارها هنگام آپلود فایلها با خطا مواجه میشوند!
🧹 مخزن فورکشده حاوی فایلهای بایگانی و رسانههای تلگرام از مخزن اصلی است. برای شروع کاملاً تمیز، همین حالا پاککننده جامع را برای تمام پلتفرمها اجرا کنید.
به Actions → aio-cleaner بروید، گزینه Clean ALL platforms را تیک بزنید و اجرا کنید.
با این کار همه چیز پاک میشود و میتوانید از صفر شروع کنید.
ℹ️ یوتیوب و اینستاگرام: برای برخی محتواها به کوکی نیاز دارند.
🔴 X (توییتر): حتماً به کوکی نیاز دارد.
🟢 تلگرام، ضبط وبسایت، و گوگل پلی: بدون کوکی کار میکنند.
- یک پنجره جدید ناشناس/خصوصی (Private/Incognito) در مرورگر خود باز کنید
- افزونه Get cookies.txt LOCALLY را نصب کنید (Chrome Web Store یا Firefox Add‑ons)
- در همان پنجره خصوصی، وارد youtube.com (برای یوتیوب)، instagram.com (برای اینستاگرام)، یا x.com (برای X) شوید
- روی آیکون افزونه کلیک کنید و Export (فرمت Netscape) را انتخاب کنید
- فایل
.txtرا در جای امنی ذخیره کنید - پنجره خصوصی را کاملاً ببندید — این کار اطمینان میدهد نشست صادرشده در جای دیگری باز نمیماند
🔴 چرا پنجره ناشناس؟ اگر در پنجره معمولی کوکی استخراج کنید و بعداً از آن سایت خارج شوید (Logout)، کوکیها بیاعتبار میشوند. پنجره ناشناس را ببندید تا نشست بسته شود اما کوکیها معتبر بمانند.
- در مخزن فورکشده، به Settings → Secrets and variables → Actions بروید
- روی New repository secret کلیک کنید
- یک secret با نام
YOUTUBE_COOKIESبسازید و محتوای فایل کوکی یوتیوب را در آن بچسبانید - یک secret با نام
INSTAGRAM_COOKIESبسازید و محتوای فایل کوکی اینستاگرام را در آن بچسبانید - یک secret با نام
X_COOKIESبسازید و محتوای فایل کوکی X را در آن بچسبانید
🔴 هرگز فایلهای کوکی را مستقیماً در مخزن commit نکنید! گردشکار از Secrets استفاده میکند و کوکیها در لاگ یا کد نمایش داده نمیشوند.
⚡ مخزنتانک YouTube! این گردشکار فراتر از یک yt‑dlp ساده است — با ۱۰ استراتژی پشتیبان (Fallback) طراحی شده تا حتی اگر متد اصلی شکست خورد، خودبهخود راههای جایگزین را امتحان کند.
| ویژگی | توضیح |
|---|---|
| 🟢 بدون نیاز به کوکی | حتی اگر YOUTUBE_COOKIES را تنظیم نکرده باشید، گردشکار با yt‑dlp بدون کوکی و ۹ متد دیگر تلاش میکند |
| 🔄 ۱۰ لایه پشتیبان خودکار | اگر دانلود اصلی شکست خورد، یکییکی ۱۰ استراتژی مختلف را امتحان میکند (نیازی به دخالت شما نیست!) |
| 📊 نمایش پیشرفت زنده | درصد و حجم دانلود را در لحظه میبینید |
| 🎯 انتخاب هوشمند کیفیت | نزدیکترین رزولوشن و FPS موجود را پیدا میکند (حتی اگر دقیقاً مقدار درخواستی وجود نداشته باشد) |
| 🔧 Remux خودکار | فایلهای دانلودی با ffmpeg بازسازی میشوند تا قابل پخش باشند |
| 📦 ZIP چندبخشی | فایلهای >۹۹MB خودکار تقسیم میشوند |
| 🌐 لینکهای غیر یوتیوب | URLهای مستقیم (غیر یوتیوب) را نیز با wget دانلود میکند |
| # | استراتژی | توضیح |
|---|---|---|
| 1 | yt-dlp اندروید |
با شبیهسازی کلاینت اندروید (player_client=android) |
| 2 | yt-dlp iOS |
با شبیهسازی کلاینت iOS |
| 3 | yt-dlp بدون کوکی |
تلاش بدون هیچ کوکی (حتی اگر کوکی تنظیم کرده باشید) |
| 4 | youtube-dl |
ابزار کلاسیک youtube-dl |
| 5 | pytube (best) |
کتابخانه pytube پایتون — بهترین کیفیت |
| 6 | pytube (resolution) |
pytube با رزولوشن درخواستی |
| 7 | API loader.to |
سرویس خارجی loader.to |
| 8 | API vevioz |
سرویس خارجی api.vevioz.com |
| 9 | cobalt.tools |
سرویس cobalt.tools (کیفیت 720p) |
| 10 | yt-dlp IPv4 + retry |
yt‑dlp با اجبار IPv4 و ۱۰ تلاش مجدد |
💡 یعنی چی؟ یعنی اگر یوتیوب متد اصلی را بلاک کند، گردشکار بیصدا ۱۰ راه مختلف را امتحان میکند تا فایل شما دانلود شود — بدون اینکه شما کاری انجام دهید. این قویترین دانلودر یوتیوب رایگانی است که روی GitHub Actions خواهید دید!
- به Actions → youtube-downloader بروید
- روی Run workflow کلیک کنید
- ورودیها را وارد کنید. فرمت:
URL v/a رزولوشن fps(fps اختیاری)
مثالها:
https://www.youtube.com/watch?v=dfdXGw1xY9A v 480
https://www.youtube.com/watch?v=dfdXGw1xY9A v 1080 60
https://www.youtube.com/watch?v=dfdXGw1xY9A a max
https://www.youtube.com/watch?v=VIDEO_ID v 4k, https://www.youtube.com/watch?v=VIDEO_ID a 128
v= ویدیو،a= صدا- رزولوشن:
max,min,1080,2k,4kو غیره - FPS: اختیاری (مثلاً
60,30) - اگر
v/aرا وارد نکنید، پیشفرض حداکثر کیفیت ویدیو انتخاب میشود
- روی Run workflow کلیک کنید → خروجی در پوشه
youtube/(با ZIP چندبخشی برای فایلهای بزرگ)
🟢 کوکی اختیاری است! اگر
YOUTUBE_COOKIESرا در Secrets تنظیم نکرده باشید، گردشکار بدون آن و با ۱۰ لایه پشتیبان کار میکند. البته افزودن کوکی شانس موفقیت در لایههای ۱ و ۲ را افزایش میدهد.
دانلود تمام رسانهها (عکس، ویدیو، استوری، Highlight، Carousel).
- به Actions → instagram-downloader بروید
- روی Run workflow کلیک کنید
- لینکهای اینستاگرام را با کاما، فاصله یا خط جدید جدا کنید
مثال:
https://www.instagram.com/p/DX2y7oLDFOb/, https://www.instagram.com/reel/DVRXhn0gjL3/, https://www.instagram.com/p/DX6US4uCNGb/
- روی Run workflow کلیک کنید → فایل ZIP در پوشه
instagram/قرار میگیرد (تا ۱۰+ لینک در یک ZIP)
دانلود تمام رسانهها (عکس، ویدیو) از توییتها و پروفایلها.
🔴 کوکی
X_COOKIESالزامی است!
- به Actions → x-downloader بروید
- روی Run workflow کلیک کنید
- لینکهای X را با کاما، فاصله یا خط جدید جدا کنید
مثال:
https://x.com/username/status/123456789, https://x.com/otheruser/status/987654321
- روی Run workflow کلیک کنید → ZIP در پوشه
x/قرار میگیرد
دانلود هر فایل از لینک مستقیم با aria2c (۱۶ اتصال موازی — بسیار سریع).
- به Actions → direct-downloader بروید
- روی Run workflow کلیک کنید
- لینکهای مستقیم (
.zip,.mp4,.apk,.pdfو غیره) را بچسبانید
مثال:
https://example.com/path/to/large-file.zip, https://example.com/another-file.mp4
- روی Run workflow کلیک کنید → فایلها در
direct/(بزرگتر از ۹۹MB به ZIP چندبخشی تقسیم میشوند)
کانالهای عمومی تلگرام را اسکن کرده و پیامها، عکسها و ویدیوها را به صورت بایگانی Markdown ذخیره میکند.
بهصورت خودکار (هر ۱۵ دقیقه) یا دستی اجرا میشود.
📡 مشاهده نمونه زنده:
مخزن اصلی این پروژه، یک بایگانی زنده از کانالهای خبری تلگرام را نگهداری میکند که هر ۱۰ دقیقه بهصورت خودکار بهروزرسانی میشود.
برای دیدن آخرین اخبار و رسانههای آن، میتوانید همین حالا این فایل را باز کنید:
telegram.md در مخزن اصلی
این فایل در فورک شما بهروزرسانی نمیشود؛ برای دریافت خودکار اخبار، اجرای گردشکار تلگرام را در فورک خود فعال کنید.
🟢 بدون نیاز به API Key یا کوکی!
⏱️ تأخیر زمانبندی خودکار: GitHub ضمانت اجرای دقیق هر ۱۵ دقیقه را نمیدهد. ممکن است تأخیرهایی تا ۱ تا ۶ ساعت بین اجراها پیش بیاید. برای دریافت لحظهای، اجرای دستی را انتخاب کنید یا اگر حرفهای هستید، یک cronjob خارجی تنظیم نمایید.
- خواندن لیست کانالها از
telegram/channels.json - راهاندازی مرورگر Chromium (Playwright) و بازدید از
https://t.me/s/ - اسکرول برای دریافت پیامهای جدید
- استخراج متن، زمان UTC، عکسها (CSS background‑url)، ویدیوها و اسناد
- دانلود رسانهها در
telegram/content/ - تبدیل زمانها به منطقه زمانی تهران و تقویم جلالی
- مرتبسازی همه پیامها از جدید به قدیم
- نوشتن در
telegram.mdبا فرمت Markdown (فونت Vazirmatn، راستبهچپ) - ذخیره آخرین شناسه پیام در
telegram/last_ids.json - Commit و push (با ۵ بار تلاش مجدد)
فایل telegram.md را در مخزن باز کنید. GitHub مارکداون را نمایش میدهد — متنهای نقلقول، تصاویر و لینک ویدیوها. تاریخها به تقویم جلالی با زمان تهران است.
فایل telegram/channels.json را ویرایش کنید (روی آیکون مداد ✏️ کلیک کنید).
🔴 نام کانالها را بدون @ وارد کنید!
❌
@channelname— نادرست ✅channelname— درست
مثال:
["VahidOOnLine", "mwarmonitor", "pm_afshaa", "iaghapour", "DEJradio", "mamlekate", "kianmeli1"]
⚠️ فقط کانالهای عمومی (Public) کار میکنند. کانالهای خصوصی قابل دسترسی نیستند.
- Actions → telegram-fetcher
- Run workflow → Run workflow
هر وبسایت عمومی را به یک فایل PDF واحد و باکیفیت تبدیل میکند. از Playwright + Chromium برای رندر کامل صفحات (جاوااسکریپت، CSS، تصاویر) استفاده میکند.
- به Actions → website-capture بروید
- روی Run workflow کلیک کنید
- آدرس کامل (حتماً با
https://شروع شود) را وارد کنید
مثالها:
https://example.com/article/my-post
https://developer.mozilla.org/en-US/docs/Web/JavaScript
https://github.com/ProAlit/aio-downloader
- کلیک کنید → ظرف ۵–۱۰ دقیقه PDF در پوشه
website/ظاهر میشود
⚠️ محدودیتها:
- فقط سایتهای عمومی (بدون دیوار ورود)
- حداکثر ۵۰۰ لینک داخلی استخراج میشود
- مهلت ۳۰ دقیقهای برای کل فرآیند
- صفحات تکصفحهای (SPA) مبتنی بر JavaScript سنگین ممکن است کامل رندر نشوند
- بدون نیاز به کوکی
💥 قدرتمندترین گردشکار این مخزن!
لیچر از yt-dlp پشتیبانی کامل میکند و تقریباً هر لینکی را میتوانید به آن بدهید — از یوتیوب و توییتر گرفته تا اینستاگرام، تیکتاک، پینترست، ساندکلود، اسپاتیفای و بیش از ۱۸۰۰ سایت دیگر.
در اینجا نه محدود به یوتیوب هستید، نه به گزینههای از پیش تعریفشده. همه چیز در کنترل شماست.
- 🟢 حالت میانبر (Shortcut): درست مثل دانلودر یوتیوب — با فرمت
URL v/a رزولوشن fps(راحت و سریع برای یوتیوب و چند سایت دیگر) - 🔴 حالت خام (Raw): قدرت بینهایت — با قرار دادن
--در انتهای URL، هر گزینه معتبرyt-dlpرا مستقیماً پاس میدهید. این یعنی میتوانید فرمت، کوکی، زیرنویس، آرشیو، پلیلیست، محدودیت نرخ و … را کاملاً دستی تنظیم کنید.
| پلتفرم | نمونه دستور (داخل ورودیهای workflow) |
|---|---|
| یوتیوب – ویدیو با کیفیت 1080p + زیرنویس انگلیسی | https://www.youtube.com/watch?v=VIDEO_ID -- --format "best[height<=1080]" --sub-lang en --write-subs |
| اینستاگرام – دانلود پست یا ریل (با کوکی) | https://www.instagram.com/p/CODE -- --cookies cookies.txt --output "%(title)s.%(ext)s" |
| تیکتاک – دانلود ویدیو و ذخیره زیرنویس | https://www.tiktok.com/@user/video/ID -- --write-subs --sub-lang en |
| توییتر / X – بهترین کیفیت موجود | https://x.com/user/status/ID -- --format best |
| پینترست – دانلود تصویر | https://www.pinterest.com/pin/ID -- --format best |
| ساندکلاد – استخراج صدا با کیفیت اصلی | https://soundcloud.com/artist/track -- --format bestaudio |
| اسپاتیفای – (متادیتا) | https://open.spotify.com/track/ID -- --print "%(title)s - %(artist)s" |
| ویــمئو – دانلود ویدیو با رزولوشن دلخواه | https://vimeo.com/ID -- --format "best[height<=720]" |
| دیلیموشن – دانلود ویدیو | https://www.dailymotion.com/video/ID -- --format best |
| تلگرام (لینک عمومی) – دانلود فایل از کانال عمومی | https://t.me/channel/12345 -- --format best |
| سایتهای مستهجن – دانلود از سایتهای مستهجن | لینک ویدئو |
ℹ️ نکته: برای سایتهایی مثل اینستاگرام و تیکتاک که به کوکی نیاز دارند، ابتدا کوکیها را به Secrets اضافه کنید (مطابق بخش ۳) و سپس در دستور
--cookies /path/to/cookies.txtرا قرار دهید. لیچر فایل کوکی را از Secret میخواند و در مسیر استاندارد ذخیره میکند.
https://www.youtube.com/watch?v=dfdXGw1xY9A v 1080
https://soundcloud.com/artist/track a 320
- به Actions → leecher بروید
- ورودیها را وارد کنید (میتوانید ترکیبی از لینکهای میانبر و خام را با هم استفاده کنید)
- میتوانید با فعال کردن تیک گزینه
leecher/همه فایلهای لیچ شده را در یک فایل زیپ دریافت کنید درغیر این صورت جداگانه آپلود میشوند. - خروجیها در پوشه
leecher/قرار میگیرند
🔴 اخطار: فضای مخزن GitHub محدودیت حدود ۵ گیگابایتی دارد! فایلهای دانلودی به سرعت فضا را پر میکنند.
این گردش کار به شما اجازه میدهد هر پلتفرم را با یک کلیک پاک کنید.
| پلتفرم | آنچه حذف میشود |
|---|---|
| تلگرام | پوشه telegram/content/ (رسانهها) و فایل telegram.md (بایگانی) و telegram/last_ids.json |
| یوتیوب / جهانی | کل پوشه youtube/ |
| اینستاگرام | کل پوشه instagram/ |
| X (توییتر) | کل پوشه x/ |
| وبسایت | کل پوشه website/ |
| لیچر | کل پوشه leecher/ |
| گوگل پلی | کل پوشه google-play/ |
- به Actions → aio-cleaner بروید
- روی Run workflow کلیک کنید
- چکباکسهای مورد نظر را تیک بزنید (یا Clean ALL platforms برای همه)
- روی Run workflow کلیک کنید
🔴 حذف دائمی است! مطمئن شوید فایلهای مهم را قبلاً دانلود و ذخیره کردهاید.
📱 فایلهای APK اندروید را مستقیماً از گوگل پلی دانلود کنید!
این گردشکار از ابزار gplay-apk-downloader برای دانلود قانونی و رسمی بستههای نصبی (APK) از سرورهای گوگل استفاده میکند — بدون نیاز به دستگاه اندروید، بدون نیاز به اکانت گوگل، و کاملاً خودکار.
- دانلود APK مستقیماً از سرورهای رسمی گوگل پلی
- پشتیبانی از معماریهای arm64 (پیشفرض) و armv7
- قابلیت ادغام خودکار APKهای Split (جداشده) در یک فایل نصبی واحد (merge_splits)
- فایلهای بزرگتر از ۹۹MB به صورت ZIP چندبخشی ذخیره میشوند
- احراز هویت گوگل پلی بهصورت خودکار توسط ابزار انجام میشود
- به Actions → google-play-downloader بروید
- روی Run workflow کلیک کنید
- سه فیلد زیر را پر کنید:
| فیلد | توضیح | اجباری؟ |
|---|---|---|
| package_name | نام پکیج اندروید برنامه (مثلاً com.google.android.youtube) |
✅ بله |
| architecture | معماری دستگاه هدف: arm64 (پیشفرض) یا armv7 |
✅ بله |
| merge_splits | ادغام APKهای Split شده در یک فایل؟ (پیشفرض: فعال) | ❌ اختیاری |
مثالها:
package_name: com.google.android.youtube
architecture: arm64
merge_splits: true
package_name: com.spotify.music
architecture: armv7
merge_splits: false
- روی Run workflow کلیک کنید → فایلهای APK (ZIP شده) در پوشه
google-play/قرار میگیرند
- به صفحه برنامه در Google Play Store بروید (مثلاً
play.google.com/store/apps/details?id=com.google.android.youtube) - به بخش
id=در URL نگاه کنید — همان نام پکیج است - یا از وبسایتهایی مثل APKMirror یا APKPure نام پکیج را جستجو کنید
ℹ️ این گردشکار فایلهای APK را مستقیماً از سرورهای گوگل دریافت میکند، بنابراین نسخههای دریافتی رسمی و دستنخورده هستند.
| هشدار | توضیح |
|---|---|
| 🔴 محدودیت فضای مخزن | حساب رایگان GitHub تا حدود ۵ گیگابایت فضای نرم دارد. فایلهای دانلودی (مخصوصاً ویدیوها و APKها) میتوانند به سرعت فضا را پر کنند. مرتباً از AIO Cleaner استفاده کنید! |
| 🟠 زمان اجرا | حداکثر ۶ ساعت برای هر اجرا (مخازن عمومی دقیقه نامحدود دارند) |
| 🟡 فایلهای >۹۹MB | به ZIP چندبخشی تقسیم میشوند — برای استخراج از 7‑Zip یا WinRAR استفاده کنید |
| 🟡 دستههای بزرگ | لینکهای خیلی زیاد را به گروههای کوچکتر تقسیم کنید |
| 🔴 دانلودر X | حتماً به کوکی نیاز دارد |
| 🟢 آرشیو تلگرام | فقط کانالهای عمومی — کانالهای خصوصی قابل دسترسی نیستند |
| 🟢 ضبط وبسایت | فقط سایتهای عمومی (بدون دیوار ورود) |
| 🔴 نام کانال تلگرام | بدون @ وارد کنید |
| 🟠 اجرای زمانبندی تلگرام | ممکن است با تأخیر ۱ تا ۶ ساعت اجرا شود. برای دریافت سریعتر، اجرای دستی قابل اعتمادتر است |
| 🔴 کوکیها | فقط از پنجره ناشناس/خصوصی استخراج کنید و بعد از استخراج، آن پنجره را کاملاً ببندید |
| 🟢 گوگل پلی | بدون نیاز به اکانت گوگل — احراز هویت خودکار است |
فایل zoomusers.md یک راهنمای جداگانه برای دور زدن تحریمها و دسترسی به سرویسهای گوگل با استفاده از کلاینت Clash Verge (ویندوز و لینوکس) و Clash Meta (اندروید) است. این فایل شامل لینکهای دانلود کلاینت، فایلهای بکاپ کانفیگ، و آموزش گامبهگام راهاندازی میباشد.
ℹ️ این فایل ارتباطی با گردشکارهای دانلود ندارد و صرفاً یک راهنمای جانبی برای کاربران ایرانی است.
باگ یا پیشنهاد؟ یک Issue باز کنید. برای رسیدگی سریعتر، لطفاً این موارد را ذکر کنید:
- نام گردش کاری که اجرا کردید
- ورودیهایی که استفاده کردید (بدون کوکیهایتان!)
- پیام خطا یا لاگ (از تب Actions کپی کنید)
First things first: If you just forked this repo, strongly run the AIO Cleaner to wipe any residual files (including Telegram archives and media from the original repo) and start completely fresh. (See section 8)
- Prerequisites
- Fork & Initial Setup
- How to Extract & Add Cookies
- Complete Workflow Guide
- Limitations & Important Warnings
- What is
zoomusers.md?
| Requirement | Description |
|---|---|
| 🟢 GitHub Account | Free — that's all you need |
| 🟠 Browser + Get cookies.txt LOCALLY extension | Chrome / Firefox / Edge |
| 🔵 Instagram Account | (Optional) for stories & private content |
| 🔴 X (Twitter) Account | Mandatory for the X downloader |
| 🟢 Telegram, Website Capture, & Google Play | Nothing extra needed — work without login or API keys |
Click the Fork button at the top‑right of this page.
- Go to your forked repo → Settings → Actions → General
- Under Actions permissions, select Allow all actions and reusable workflows
- Click Save
- Same path → Workflow permissions
- Select Read and write permissions
- Click Save
⚠️ If you skip this step, all workflows will fail when trying to upload files!
🧹 Your forked repo contains Telegram archives and media from the original repo. To start with a clean slate, run the AIO Cleaner now for all platforms.
Go to Actions → aio-cleaner, check Clean ALL platforms, and run it.
This will wipe everything so you can begin fresh.
ℹ️ YouTube & Instagram: May require cookies for some content.
🔴 X (Twitter): Cookies are MANDATORY.
🟢 Telegram, Website Capture, & Google Play: No cookies needed.
- Open a new Private/Incognito window in your browser
- Install the Get cookies.txt LOCALLY extension (Chrome Web Store or Firefox Add‑ons)
- In that private window, log into youtube.com (for YouTube), instagram.com (for Instagram), or x.com (for X)
- Click the extension icon and choose Export (Netscape format)
- Save the
.txtfile somewhere safe - Close the private window completely — this ensures the exported session isn't kept open elsewhere
🔴 Why a private window? If you export cookies from a normal window and later log out, the cookies become invalid. Closing a private window ends the session while keeping the exported cookies valid.
- In your forked repo, go to Settings → Secrets and variables → Actions
- Click New repository secret
- Create a secret named
YOUTUBE_COOKIESand paste your YouTubecookies.txtcontent - Create a secret named
INSTAGRAM_COOKIESand paste your Instagramcookies.txtcontent - Create a secret named
X_COOKIESand paste your X (Twitter)cookies.txtcontent
🔴 Never commit cookie files directly to the repository! The workflow reads from secrets and cookies are never exposed in logs or code.
⚡ Tank-mode YouTube! This workflow is far more than a simple yt‑dlp call — it's built with 10 automatic fallback strategies so if the primary method fails, it silently cycles through alternatives until something works.
| Feature | Description |
|---|---|
| 🟢 Cookieless Operation | Even without YOUTUBE_COOKIES set, the workflow tries yt‑dlp cookieless + 9 other methods |
| 🔄 10 Automatic Fallbacks | If the main download fails, it tries 10 different strategies one by one — no user intervention needed! |
| 📊 Real-time Progress | See download percentage and byte count as it downloads |
| 🎯 Smart Quality Matching | Finds the closest available resolution and FPS (even if your exact request doesn't exist) |
| 🔧 Auto Remux | Downloaded files are remuxed with ffmpeg for guaranteed playability |
| 📦 Multi-part ZIP | Files >99MB are automatically split into ZIP parts |
| 🌐 Non-YouTube Links | Direct URLs (non-YouTube) are also handled via wget |
| # | Strategy | Description |
|---|---|---|
| 1 | yt-dlp Android |
Simulates Android client (player_client=android) |
| 2 | yt-dlp iOS |
Simulates iOS client |
| 3 | yt-dlp No Cookies |
Attempts without any cookies at all |
| 4 | youtube-dl |
Classic youtube-dl tool |
| 5 | pytube (best) |
Python pytube library — best quality |
| 6 | pytube (resolution) |
pytube with your requested resolution |
| 7 | API loader.to |
External loader.to service |
| 8 | API vevioz |
External api.vevioz.com service |
| 9 | cobalt.tools |
cobalt.tools API (720p quality) |
| 10 | yt-dlp IPv4 + retry |
yt‑dlp with forced IPv4 + 10 retries |
💡 What does this mean? If YouTube blocks the primary method, the workflow silently tries 10 completely different approaches until your file is downloaded — all without you lifting a finger. This is the most resilient free YouTube downloader you'll see on GitHub Actions!
- Go to Actions → youtube-downloader
- Click Run workflow
- Enter your inputs. Format:
URL v/a resolution fps(fps optional)
Examples:
https://www.youtube.com/watch?v=dfdXGw1xY9A v 480
https://www.youtube.com/watch?v=dfdXGw1xY9A v 1080 60
https://www.youtube.com/watch?v=dfdXGw1xY9A a max
https://www.youtube.com/watch?v=VIDEO_ID v 4k, https://www.youtube.com/watch?v=VIDEO_ID a 128
v= video,a= audio- Resolution:
max,min,1080,2k,4k, etc. - FPS: optional (e.g.,
60,30) - If
v/ais omitted, defaults to video max quality
- Click Run workflow → output appears in
youtube/folder (split ZIP for large files)
🟢 Cookies are optional! If you haven't set up
YOUTUBE_COOKIESin Secrets, the workflow still works with cookieless yt‑dlp + all 9 other fallback layers. Adding cookies does improve success rates for layers 1 & 2 though.
Downloads all media from posts, reels, stories, highlights, and profiles — including mixed carousels.
- Go to Actions → instagram-downloader
- Click Run workflow
- Paste Instagram links — separated by commas, spaces, or newlines
Example:
https://www.instagram.com/p/DX2y7oLDFOb/, https://www.instagram.com/reel/DVRXhn0gjL3/, https://www.instagram.com/p/DX6US4uCNGb/
- Click Run workflow → ZIP appears in the
instagram/folder (up to 10+ links bundled in one ZIP)
Downloads all media (images, videos) from tweets and profiles.
🔴
X_COOKIESsecret is mandatory!
- Go to Actions → x-downloader
- Click Run workflow
- Paste X links — separated by commas, spaces, or newlines
Example:
https://x.com/username/status/123456789, https://x.com/otheruser/status/987654321
- Click Run workflow → ZIP appears in the
x/folder
Downloads any file from a direct URL using aria2c (16 parallel connections — ultra‑fast).
- Go to Actions → direct-downloader
- Click Run workflow
- Paste direct download URLs (e.g.,
.zip,.mp4,.apk,.pdf), separated by commas, spaces, or newlines
Example:
https://example.com/path/to/large-file.zip, https://example.com/another-file.mp4
- Click Run workflow → files appear in
direct/(split into 99 MB parts if needed)
Scrapes public Telegram channels and stores messages, photos, videos, and documents as a Markdown archive.
Runs automatically every 15 minutes or manually on demand.
📡 Live Example:
The original repository maintains a live archive of Telegram news channels, refreshed automatically every 10 minutes.
To view the latest news and media, open the file here:
telegram.md on the original repo
This file is not updated in your fork unless you activate the Telegram workflow on your own copy.
🟢 No API key or cookies needed!
⏱️ Automatic cron delay: GitHub does not guarantee exact 15‑minute intervals. Delays of 1 to 6 hours between runs are common. For real‑time updates, use manual trigger or set up an external cron job if you're experienced.
- Reads your channel list from
telegram/channels.json - Launches Chromium (Playwright) and visits
https://t.me/s/ - Scrolls to fetch new messages since the last check
- Extracts message text, UTC times, photos (CSS background‑url), videos, and documents
- Downloads all media into
telegram/content/ - Converts UTC times to Iran/Tehran timezone and Jalali (Hijri‑Shamsi) calendar
- Sorts all messages from newest to oldest
- Writes to
telegram.mdwith Markdown formatting (Vazirmatn font, RTL) - Saves last message IDs in
telegram/last_ids.json - Commits and pushes (with a 5‑retry loop)
Open telegram.md in your repository. GitHub renders Markdown natively — you'll see formatted text with quotes, embedded images, and clickable video links. Dates are in Jalali calendar with Tehran timezone.
Edit telegram/channels.json directly on GitHub (click the pencil icon ✏️).
🔴 Channel names must be WITHOUT the @ symbol!
❌
@channelname— incorrect ✅channelname— correct
Example:
["VahidOOnLine", "mwarmonitor", "pm_afshaa", "iaghapour", "DEJradio", "mamlekate", "kianmeli1"]
⚠️ Only public channels work. Private channels cannot be accessed.
- Actions → telegram-fetcher
- Run workflow → Run workflow
Turns any public website into a single, polished A4 PDF document. Uses Playwright + Chromium to render pages exactly like a real user — including JavaScript, CSS, images, and dynamic content.
- Go to Actions → website-capture
- Click Run workflow
- Enter the full URL (must start with
https://)
Examples:
https://example.com/article/my-post
https://developer.mozilla.org/en-US/docs/Web/JavaScript
https://github.com/ProAlit/aio-downloader
- Click Run workflow → within 5–10 minutes, the PDF appears in the
website/folder
⚠️ Limitations:
- Only public sites (no login walls)
- Up to 500 internal links extracted
- 30‑minute timeout for the entire process
- JavaScript‑heavy single‑page apps may not render perfectly
- No cookies needed!
💥 The most powerful workflow in this repo!
Leecher fully harnesses yt-dlp, so you can throw almost any link at it — YouTube, Twitter, Instagram, TikTok, Pinterest, SoundCloud, Spotify, and over 1,800 other sites.
You are not limited to YouTube, nor to predefined settings. You're in full control.
- 🟢 Shortcut Mode: Just like the YouTube downloader — using the format
URL v/a resolution fps(quick and simple for YouTube and similar) - 🔴 Raw Mode: Limitless power — append
--after the URL and pass any validyt-dlpoption directly. This means you can manually set formats, cookies, subtitles, archive, playlists, rate limits, and more.
| Platform | Example command (paste into workflow input) |
|---|---|
| YouTube – 1080p video + English subs | https://www.youtube.com/watch?v=VIDEO_ID -- --format "best[height<=1080]" --sub-lang en --write-subs |
| Instagram – Download post/reel (with cookies) | https://www.instagram.com/p/CODE -- --cookies cookies.txt --output "%(title)s.%(ext)s" |
| TikTok – Download video & captions | https://www.tiktok.com/@user/video/ID -- --write-subs --sub-lang en |
| Twitter / X – Best available resolution | https://x.com/user/status/ID -- --format best |
| Pinterest – Get the image | https://www.pinterest.com/pin/ID -- --format best |
| SoundCloud – Extract original audio | https://soundcloud.com/artist/track -- --format bestaudio |
| Spotify – (metadata) | https://open.spotify.com/track/ID -- --print "%(title)s - %(artist)s" |
| Vimeo – Download with custom resolution | https://vimeo.com/ID -- --format "best[height<=720]" |
| Dailymotion – Download video | https://www.dailymotion.com/video/ID -- --format best |
| Telegram (public link) – Grab file from public channel | https://t.me/channel/12345 -- --format best |
| Porn Downloader – All Porn Websites | Link To Video |
ℹ️ Note: For sites like Instagram and TikTok that require cookies, first add your cookies to Secrets (section 3) and then include
--cookies /path/to/cookies.txt. Leecher automatically reads the cookie secret and saves it in the expected location.
https://www.youtube.com/watch?v=dfdXGw1xY9A v 1080
https://soundcloud.com/artist/track a 320
- Go to Actions → leecher
- Enter your inputs (you can mix shortcut and raw links in the same run)
- You can toggle the - zip all downloads into one archive? (If disabled, each file is zipped individually)
- Outputs appear in the
leecher/folder
🔴 Warning: GitHub repos have a ~5 GB soft limit! Downloaded files can eat up space fast.
This workflow lets you wipe downloads for any platform with one click.
| Platform | What Gets Deleted |
|---|---|
| Telegram | telegram/content/ folder (media), telegram.md (archive), telegram/last_ids.json |
| YouTube / Universal | Entire youtube/ folder |
Entire instagram/ folder |
|
| X (Twitter) | Entire x/ folder |
| Website | Entire website/ folder |
| Leecher | Entire leecher/ folder |
| Google Play | Entire google-play/ folder |
- Go to Actions → aio-cleaner
- Click Run workflow
- Check the boxes you want (or Clean ALL platforms for everything)
- Click Run workflow
🔴 Deletion is permanent! Make sure you've downloaded important files beforehand.
📱 Download Android APK files directly from Google Play!
This workflow uses the gplay-apk-downloader tool to legally fetch installable packages (APKs) from Google's official servers — no Android device needed, no Google account required, fully automated.
- Downloads APKs directly from Google's official servers
- Supports arm64 (default) and armv7 architectures
- Automatically merges Split APKs into a single installable file (
merge_splits) - Files larger than 99 MB are split into multi‑part ZIP archives
- Google Play authentication is handled automatically by the tool
- Go to Actions → google-play-downloader
- Click Run workflow
- Fill in the three fields:
| Field | Description | Required? |
|---|---|---|
| package_name | Android package name (e.g., com.google.android.youtube) |
✅ Yes |
| architecture | Target device architecture: arm64 (default) or armv7 |
✅ Yes |
| merge_splits | Merge split APKs into one file? (default: enabled) | ❌ Optional |
Examples:
package_name: com.google.android.youtube
architecture: arm64
merge_splits: true
package_name: com.spotify.music
architecture: armv7
merge_splits: false
- Click Run workflow → APK files (zipped) appear in the
google-play/folder
- Go to the app's page on the Google Play Store (e.g.,
play.google.com/store/apps/details?id=com.google.android.youtube) - Look at the
id=part in the URL — that's the package name - Alternatively, use sites like APKMirror or APKPure to search for the package name
ℹ️ This workflow fetches APK files directly from Google's servers, so the downloads are official and unmodified.
| Warning | Description |
|---|---|
| 🔴 Repository Size Limit | GitHub free accounts have a ~5 GB soft limit. Downloaded files (especially videos and APKs) can fill this up quickly. Use AIO Cleaner regularly! |
| 🟠 Runtime | Max 6 hours per job (public repos have unlimited minutes) |
| 🟡 Files >99 MB | Split into multi‑part ZIPs — use 7‑Zip or WinRAR to extract |
| 🟡 Large Batches | Split very large batches into smaller groups |
| 🔴 X Downloader | Requires cookies — won't work without X_COOKIES |
| 🟢 Telegram Archive | Only public channels — private channels cannot be accessed |
| 🟢 Website Capture | Only public sites (no login walls) |
| 🔴 Telegram Channel Names | Must be without @ |
| 🟠 Telegram Cron | May experience delays of 1–6 hours. Manual trigger is more reliable |
| 🔴 Cookies | Only export from a Private/Incognito window — close that window completely after exporting |
| 🟢 Google Play | No Google account needed — authentication is automatic |
The zoomusers.md file is a separate guide for bypassing internet restrictions and accessing Google services using the Clash Verge client (Windows & Linux) and Clash Meta (Android). It includes download links, config backup files, and step‑by‑step setup instructions.
ℹ️ This file is unrelated to the download workflows — it's a bonus guide for Iranian users.
⭐ If this project helps you, please star the repo — it helps others find it!
Bug or suggestion? Open an Issue. For faster resolution, please include:
- The workflow name you ran
- The inputs you used (without your cookies!)
- Error message or log (copy from the Actions tab)