عن المشروع

open-Xdownload هو أداة تحميل وسائط لـ X/Twitter تعتمد على التشغيل المحلي، وتتميز بواجهة ويب مدمجة وطابور مهام في الخلفية. يدعم أربعة أنواع من المهام—المنشورات الفردية، والمستخدمين، والقوائم، والحسابات المتبوعة—ويوفر المهام الدفعية، والخطط المجدولة، والأرشفة التدرّجية، وإعادة المحاولة عند الفشل، ومجموعة ملفات تعريف الارتباط لتبديل حدّ Rate-Limit. القدرات الرئيسية: - تحليل وتحميل المنشور الفردي: الصق رابط x.com أو twitter.com لتحليل النص والكاتب وقائمة الوسائط، ثم تحميل أفضل نسخة متاحة من كل صورة أو فيديو أو GIF. - أرشفة وسائط المستخدم: احفظ وسائط من جدول المستخدم الزمني باسم المستخدم أو @اسم المعالج أو معرف المستخدم. - أرشفة القائمة: أدخل معرف قائمة X لجلب الأعضاء وأرشفة وسائطهم. - أرشفة الحسابات المتبوعة: جلب الحسابات التي يتابعها الهدف وأرشفة وسائط تلك الحسابات. - المهام الدفعية: أدخل ما يصل إلى 200 هدف (مستخدمين، قوائم، حسابات متبوعة) في آن واحد مع إزالة التكرار تلقائيًا. - الخطط المجدولة: احفظ الأهداف كخطط أرشفة متكررة بفواصل زمنية قابلة للتكوين (5–43200 دقيقة). - الأرشفة التدرّجية: استئناف من آخر موقع ناجح في التشغيل المتكرر; تخطي الوسائط المُحمّلة مسبقًا. - معالجة الفشل: العيوب الجزئية مُعلَّمة بوضوح; تدخل المنشورات الفاشلة طابور إعادة المحاولة الذي يمكن إعادة تشغيله يدويًا أو تلقائيًا عند اكتمال المهمة. - مجموعة ملفات تعريف الارتباط: ملف تعريف ارتباط أساسي بالإضافة إلى مجموعات احتياطية متعددة لتبديل حدّ Rate-Limit أثناء الأرشفة الدفعية. - مكتبة الوسائط: تصفح الوسائط المُحمّلة حسب فئة الصور أو الفيديو أو GIF; ابحث في أسماء الملفات وروابط الوسائط ومعرفات المنشورات; معاينات محمّلة بالكسل مع تنقل بلوحة المفاتيح. - معاينات خفيفة الوزن: الصور تُحمّل بالكسل; الفيديو يُحمّل مصغّر البوستر فقط افتراضيًا، ويُفعَّل المشغّل فقط في المعاينة المكبرة. - تخزين المجلد المحلي: دليل التحميل قابل للتكوين عبر واجهة المستخدم أو سطر الأوامر، مع مسارات قابلة للاستعراض والإنشاء. خيارات النشر: - Docker Compose (موصى به): المنافذ 127.0.0.1:8787، أحجام للبيانات والتحميلات، PUID/PGID قابلة للتكوين. - Docker run: نفس متغيرات البيئة، استدعاء يدوي. - الملف التنفيذي: تحميله من Releases; يستمع إلى 127.0.0.1:8787 افتراضيًا، مع إعدادات قابلة للتكوين لعنوان addr، ومجلد البيانات data-dir، ومجلد الويب web-dir، ومجلد التحميل download-dir. الخدمة لا تحتوي على مصادقة مدمجة وتلتصق بـ localhost افتراضيًا. يتطلب الوصول عبر الشبكة المحلية تعيين العنوان صراحةً إلى 0.0.0.0:8787 ووضع الخدمة خلف proxy عكسي موثّق. يُخزَّن البيانات في قاعدة بيانات SQLite (open-xdownload.db) ومجلدات التحميل المحلية. الحقول الحساسة (ملفات تعريف الارتباط) مُقنّعة في واجهة المستخدم. يجب أن تشمل النسخ الاحتياطية كلًا من قاعدة البيانات ومجلد التحميل. الترخيص: MIT.