عن المشروع

PWA Karaoke هو تطبيق كاريوكي قائم على الويب يحول أي جهاز إلى نظام كاريوكي. يعمل بالكامل في المتصفح ويدعم Docker Compose، وDocker المستقل، وطرق الإعداد اليدوي. تشمل الميزات الرئيسية ما يلي: - **أدوار متعددة الأجهزة**: استخدم الهاتف أو الجهاز اللوحي كجهاز تحكم للبحث عن الأغاني وإدارتها، بينما يعمل أي جهاز يدعم الويب (تلفزيون، جهاز عرض، شاشة) كشاشة عرض تعرض تشغيل الفيديو وقائمة انتظار الأغاني. - **دعم الغرف المتعددة**: إنشاء غرف كاريوكي متعددة ومستقلة، مع إمكانية حماية كل منها بكلمة مرور اختيارياً. - **البحث عن الأغاني وجدولتها**: ابحث عن الأغاني من منصات بث الفيديو وضعها في قائمة الانتظار للتشغيل. - **التشغيل التلقائي**: يتم تشغيل الأغاني المحجوزة بالتتابع بشكل افتراضي؛ ويتيح مفتاح التبديل للتشغيل التلقائي التحكم اليدوي. - **تسجيل النقاط**: يتم تقييم الأغاني بنقاط عند انتهائها، مع دعم إدخال الميكروفون عبر ميزة "Mic Check" (فحص الميكروفون) على أجهزة التحكم. - **الأسماء المستعارة**: تحدد أجهزة التحكم المستخدمين بأسماء مستعارة (تصل إلى 14 حرفاً) تظهر على الشاشة بجوار الأغاني المحجوزة. - **الاقتران برمز QR**: قم بتوصيل جهاز التحكم بسرعة بشاشة العرض عن طريق مسح رمز QR المعروض على شاشة الانتظار الخاصة بالشاشة. خيارات الإعداد: - Docker Compose (موصى به): يبدأ تشغيل الواجهة الخلفية وخادم الويب Caddy بأمر واحد. - Docker: بناء وتشغيل الحاوية بشكل منفصل. - يدوي: يتطلب Python 3.11+ وNode.js 20+ وyt-dlp لمعالجة الفيديو. متطلبات النظام: حد أدنى 2 جيجابايت من ذاكرة الوصول العشوائي (RAM)، ووحدة معالجة مركزية افتراضية واحدة (1 vCPU). مخصص للاستخدام الشخصي وغير التجاري. مرخص بموجب رخصة MIT.