در این راهنما قدمبهقدم یاد میگیرید چطور از این ابزار برای دانلود خودکار فایلهای تلگرام (عکس، فیلم، صدا، مستندات و ...) استفاده کنید. فقط کافیه یکبار تنظیمات اولیه رو انجام بدید، بعد از اون برای هر بار دانلود فقط چند کلیک نیاز دارید.
- وارد سایت GitHub بشید.
- اگر حساب کاربری ندارید، اول ثبتنام کنید.
- بعد با اکانت خودتون لاگین کنید.
🔐 لاگین بودن خیلی مهمه، چون بقیه مراحل فقط وقتی انجام میشه که وارد حساب خودتون باشید.
یعنی چی فورک؟
یعنی یک کپی کامل از این پروژه رو به حساب گیتهاب خودتون منتقل میکنید.
چجوری انجام بدید؟
- توی صفحه اصلی این پروژه، روی دکمه Fork (در بالا سمت راست) کلیک کنید.
- توی صفحه باز شده:
- اسم دلخواه برای ریپازیتوری جدیدتون انتخاب کنید (مثلاً
MyTelegramDownloader) - بقیه تنظیمات رو همون پیشفرض نگه دارید.
- اسم دلخواه برای ریپازیتوری جدیدتون انتخاب کنید (مثلاً
- در نهایت روی دکمه سبز Create fork کلیک کنید.
✅ بعد از چند ثانیه، یک کپی از پروژه توی اکانت خودتون ساخته میشه.
این مرحله خیلی مهمه. اگر این کار رو نکنید، فایل دانلود شده توی ریپازیتوری شما ذخیره نمیشه.
مسیر دقیق تنظیمات:
- توی ریپازیتوری فورک شده خودتون (مال خودتون، نه این یکی) وارد بشید.
- روی تب Settings کلیک کنید.
- در منوی سمت چپ، روی Actions کلیک کنید.
- بعد روی General کلیک کنید.
- صفحه رو پایین بیارید تا برسید به بخش Workflow permissions.
- گزینه Read and write permissions رو انتخاب کنید.
- در نهایت روی دکمه سبز Save کلیک کنید.
🛠️ این تنظیمات اجازه میدهد که فایل دانلود شده در ریپازیتوری شما آپلود شود.
وقتی شما یک ریپازیتوری رو فورک میکنید، گاهی اکشنها به طور خودکار غیرفعال میشوند.
برای فعال کردن:
- توی ریپازیتوری خودتون، روی تب Actions کلیک کنید.
- پیامی شبیه این میبینید:
"Workflows aren't being run on this forked repository" - روی دکمه
"I understand my workflows, go ahead and enable them"
کلیک کنید.
✅ از این به بعد، اکشنهای این ریپازیتوری میتونند اجرا بشوند.
حالا بریم سر اصل مطلب؛ دانلود کردن فایل از تلگرام.
- از منوی بالای ریپازیتوری، روی تب Actions کلیک کنید.
- در نوار سمت چپ، روی Telegram Downloader کلیک کنید.
اگر این اسم رو نمیبینید، مطمئن بشید ریپازیتوری درست رو انتخاب کردید.
- یک کادر آبی رنگ با عنوان "This workflow has a workflow_dispatch event trigger" ظاهر میشه.
- سمت راست این کادر، روی دکمه Run workflow کلیک کنید.
- یک پنجره باز میشه که باید اطلاعات زیر رو وارد کنید:
| فیلد | توضیح | مثال |
|---|---|---|
| Telegram link | لینک پست تلگرام | https://t.me/ChannelName/123 |
| Split threshold MB | حداکثر حجم هر فایل (عدد 0 یعنی تقسیم نشه) | 90 |
✨ نکته: این ابزار هر نوع فایلی (عکس، فیلم، صدا، PDF، ZIP، RAR و ...) رو پشتیبانی میکنه.
- بعد از پر کردن اطلاعات، روی دکمه سبز رنگ Run workflow کلیک کنید.
✅ کار شروع شد! فقط کافیه صبر کنید تا تموم بشه.
- معمولاً این فرایند بین ۱ تا ۱۰ دقیقه طول میکشه، بسته به حجم فایل.
- توی همون صفحه Actions میتونید مراحل اجرا رو لایو ببینید.
چطور بفهمیم کار تموم شده؟
- وقتی اجرای وورکفلو تموم بشه، کنار اسمش یک تیک سبز رنگ ✅ ظاهر میشه.
- اگر خطایی پیش بیاد، علامت ❌ قرمز نشان داده میشه.
🧠 توی حین اجرا، میتونید روی وورکفلو کلیک کنید و خروجی مراحل رو مشاهده کنید.
بعد از سبز شدن علامت کار، فایل(های) دانلود شده در ریپازیتوری شما آپلود میشوند.
مسیر دسترسی به فایل:
- توی ریپازیتوری خودتون، روی تب Code کلیک کنید.
- پوشه downloads رو باز کنید.
- فایلهای دانلود شده رو اونجا مشاهده میکنید.
📁 نکته: اسم فایلهای فارسی به طور خودکار به اسم انگلیسی رندم تبدیل میشوند تا مشکل با گیتهاب نداشته باشند.
اگر حجم فایل از مقدار Split threshold MB که وارد کردید بیشتر باشه، فایل به چند پارت تقسیم میشه.
مثال:
اگر Split threshold MB = 90 و فایل ۲۵۰ مگابایت باشه، تبدیل به سه فایل میشه:
a1b2c3d4.zipa1b2c3d4.z01a1b2c3d4.z02
طریقه اکسترکت کردن (باز کردن):
- همه فایلهای پارت رو داخل یک پوشه دانلود کنید.
- فقط روی فایل اصلی که پسوند
.zipداره کلیک راست کنید. - گزینه Extract Here یا Extract to ... رو انتخاب کنید.
- فایل اصلی و کامل به دستتون میاد.
⚠️ نکته مهم: اگر فقط فایل.zipرو اکسترکت کنید، خطا میدهد. حتماً همه پارتها در کنار هم باشند.
| مرحله | کاری که باید بکنید |
|---|---|
| ۱ | وارد گیتهاب بشید |
| ۲ | پروژه رو فورک کنید |
| ۳ | تنظیمات Actions رو Read/Write کنید |
| ۴ | Actions رو فعال کنید |
| ۵ | Run workflow بزنید و لینک تلگرام رو بدید |
| ۶ | منتظر بمونید تا سبز بشه |
| ۷ | فایل رو از پوشه downloads بردارید |
| ۸ | اگر چند پارت بود همه رو اکسترکت کنید |
س: چه نوع فایلهایی قابل دانلود است؟
ج: بیشتر نوع فایل (عکس، فیلم، صدا، GIF، PDF، ZIP، RAR، مستندات و ...)
س: چرا فایل دانلود شده در ریپازیتوری من نمیاد؟
ج: حتماً مرحله ۳ (تنظیم دسترسی Read/Write) رو انجام دادید؟ اون مرحله خیلی مهمه.
س: چقدر طول میکشه تا فایل دانلود بشه؟
ج: بستگی به حجم فایل داره. فایلهای کوچک چند ثانیه، فایلهای بزرگ (چند گیگابایت) ممکنه چند دقیقه طول بکشه.
س: چرا اسم فایل عوض شده؟
ج: فایلهای با اسم فارسی یا کاراکترهای غیرانگلیسی به طور خودکار به اسم رندم انگلیسی تبدیل میشوند تا گیتهاب بتونه اون رو به درستی مدیریت کنه..
س: اگر فایل چند پارت بود چیکار کنم؟
ج: همه قطعات رو در یک پوشه دانلود کنید و فقط روی فایل .zip کلیک راست کرده و Extract کنید.
اگر از این پروژه استفاده میکنید و براتون مفید بوده، میتونید از طریق لینک زیر حمایت کنید:
حتی یک حمایت کوچیک، انگیزه من برای توسعه بیشتر این نوع پروژهها رو چند برابر میکنه! 🙏