رسم توضيحي لتحميل ملف إلى جهاز — غلاف مشروع بوت تحميل الوسائط
رسم توضيحي لتحميل ملف إلى جهاز — غلاف مشروع بوت تحميل الوسائط
مشروع

بوت تحميل الوسائط — Download Media Bot

بوت تليجرام يسحب الفيديو والصور والصوت من تسع منصات — تيك توك، إنستغرام، إكس، يوتيوب، فيسبوك، ثريدز، ساوند كلاود، سبوتيفاي، بنترست. مبني على Hono و grammY و Cloudflare Workers. أرسل الرابط، يصلك الملف.

بوت تليجرام لتحميل الوسائط مبني على Hono و grammY و Cloudflare Workers. أرسل رابطًا من أي منصة مدعومة داخل المحادثة ويعيد لك الملف — بلا تطبيق، بلا علامة مائية، وبلا تحويل إلى صفحات إعلانات.

البوت متاح على @download_media_4bot .

المنصات المدعومة

  • تيك توك — فيديو بدون علامة مائية، صوت بجودة عالية، وعروض الصور
  • إنستغرام — الريلز والفيديو والصور ومنشورات الكاروسيل
  • تويتر / إكس — فيديو وصور بدقة عالية
  • يوتيوب — فيديو HD/SD واستخراج الصوت MP3
  • فيسبوك — فيديو HD/SD
  • ثريدز — فيديو وصور
  • ساوند كلاود — مقاطع صوتية بجودة عالية
  • سبوتيفاي — معاينات صوتية وتحميل المقاطع
  • بنترست — فيديو وصور بدقة عالية

ما يفعله أبعد من جلب الملفات

  • اختيار الجودة — لوحة أزرار للمنصات التي توفر أكثر من نسخة، حتى لا تعود روابط يوتيوب وفيسبوك بأسوأ جودة بصمت.
  • يعمل على الحافة — شبكة Cloudflare العالمية تختصر زمن الاستجابة أينما كان المستخدم.
  • إحصاءات — عدد التحميلات وتتبع لكل مستخدم عبر Cloudflare KV و Analytics Engine، تظهر للمشرف عبر /stats.
  • ثنائي اللغة — يكتشف لغة حساب المستخدم في تليجرام ويبدل بين العربية والإنجليزية.
  • بوابة اشتراك — تحقق اختياري من الاشتراك في قناة قبل السماح بالتحميل، يضبطه المشرف أثناء التشغيل.
  • إعداد ذاتي — تسجيل الـ webhook وإعداد البوت يجريان تلقائيًا بعد النشر؛ زيارة /setup مرة واحدة تكمل الإعداد.

التقنيات المستخدمة

Hono لطبقة HTTP داخل الـ Worker، و grammY لجانب تليجرام، و Cloudflare Workers للتنفيذ، و Workers KV للتخزين المؤقت والحالة، و Analytics Engine للمقاييس اللحظية. الاختبارات على Vitest، والمستودع يفرض صيغة conventional commits ويشغل فحوصات CodeQL وجودة الكود مع كل دفعة.

الأوامر

  • /start — بدء البوت ورسالة ترحيب
  • /help — طريقة الاستخدام
  • إرسال رابط — وهذا كل شيء؛ لا حاجة لأي أمر
  • /stats (مشرف) — إحصاءات التحميل والاستخدام لكل مستخدم
  • /cancel (مشرف) — إلغاء التحميل المعلق

تشغيل نسختك الخاصة

تحتاج حساب Cloudflare مفعلًا عليه Workers، وتوكن بوت من @BotFather ، و Node.js مع pnpm.

git clone https://github.com/EngDawood/download-media.git
cd download-media
pnpm install

# ضع معرف تليجرام الرقمي في ADMIN_TELEGRAM_ID داخل wrangler.jsonc ثم:
pnpm exec wrangler secret put TELEGRAM_BOT_TOKEN
pnpm exec wrangler secret put TELEGRAM_WEBHOOK_SECRET

pnpm deploy

ثم زُر https://your-worker-url/setup مرة واحدة لتسجيل الـ webhook. وأمر pnpm dev يشغله محليًا، و pnpm test يشغل اختبارات Vitest.

تريد شيئًا مشابهًا لفريقك؟ أبدأ عادةً بنسخة أولى خلال أسبوعين.

تواصل معي