عن المشروع

TubeSync هو مسجّل فيديو شخصي (PVR) ذاتي الاستضافة لـ YouTube، ويوصف بأنه مشابه لـ Sonarr لكن لـ YouTube، مع عميل تنزيل مدمج. يزامن القنوات وقوائم التشغيل من YouTube إلى أدلة محلية ويمكنه تحديث خادم وسائط بعد تنزيل الوسائط. داخليًا هو واجهة ويب تغلّف yt-dlp وffmpeg مع مجدول مهام. وعناصر التمييز المعلنة هي تجربة PVR كاملة لتحديث خوادم الوسائط واختيار أفضل لصيغ الوسائط. كما يطبّق إعادة محاولة تدريجية للفشل مع مؤقتات تراجع، بحيث تُعاد محاولة التنزيلات الفاشلة على مدى فترة ممتدة. النشر يعتمد الحاويات أولًا: تُنشر صورة حاوية على ghcr.io/meeb/tubesync:latest، مع دعم amd64 وarm64، وتوثّق أمثلة Docker أو Podman مع Docker Compose. تُثبّت الإعدادات والتنزيلات كوحدات تخزين (/config و/downloads)، مع متغيرات البيئة PUID وPGID وTZ. يتوفر مصادقة HTTP الأساسية الاختيارية عبر HTTP_USER وHTTP_PASS. تُنظَّم الوسائط المنزّلة في أدلة فرعية للفيديو والصوت تحت دليل التنزيل، وتذهب الوسائط الصوتية فقط إلى audio. تتم الإدارة عبر واجهة الويب على المنفذ 4848. تُضاف المصادر عبر URL مع التحقق، وتشمل خيارات كل مصدر تكرار الفهرسة وجودة التنزيل. تعمل الفهرسة والتنزيل تلقائيًا ضمن مهام مجدولة، وتظهر في تبويب المهام، وتظهر الوسائط في تبويب الوسائط. يُدعم Plex وJellyfin كخوادم وسائط. يحذّر README بشأن تكرار الفهرسة وفهرسة القنوات الكبيرة جدًا، وينصح بفواصل زمنية طويلة وفهرسة وتنزيلات متزامنة بأقل قدر ومهذبة لتجنب التقييد أو الحظر. تغطي متغيرات البيئة المتقدمة إعدادات Django، وبادئة URL، ووضع التصحيح، والمضيفين المسموحين، وحد ارتفاع الفيديو، وإعادة تسمية المصدر، وبادئات الأدلة، وتقليص البيانات الوصفية، وعمال gunicorn، ومضيف/منفذ الاستماع، واتصال قاعدة بيانات خارجية اختياري. ويوثّق مسار تثبيت Django يدويًا بدون حاويات، مع مجموعة اختبارات قابلة للتشغيل عبر manage.py test.