عن المشروع

TV Launcher هو مشغّل تطبيقات بملء الشاشة بأسلوب وحدات التحكم لنظامي Windows وLinux، مكتوب بلغة Python مع PyQt6. يعرض البرامج المثبّتة في واجهة دوّارة (carousel) مخصّصة للاستخدام بوضع الاسترخاء على شاشة تلفاز أو سطح مكتب، مع تحجيم تلقائي من 720p حتى 4K وما بعده. الإدخال والتنقّل يدعم أذرع تحكم بنمط Xbox/PlayStation، ولوحات المفاتيح، وأجهزة التحكم عن بُعد عبر Bluetooth، والفأرة واللمس. تُكتشف أذرع التحكم تلقائياً على فترات دورية مع إشعارات على الشاشة. يمكن إعادة تعيين كل مفتاح أو زر جهاز تحكم عن بُعد من خلال لوحة Key Remapper في الإعدادات، ويمكن نسخ التعيينات احتياطياً أو استعادتها أو إعادة تعيينها إلى الإعدادات الافتراضية. إدارة المكتبة يكتشف ماسح البرامج التطبيقات المثبّتة ويستخرج أيقوناتها، ويخزّن النتائج مؤقتاً لتحميل أسرع لاحقاً. يمكن أيضاً إضافة التطبيقات يدوياً عبر تصفّح ملف تنفيذي. يمكن تحرير الإدخالات أو حذفها أو البحث فيها عبر أداة بحث سريعة، وإعادة ترتيبها من خلال وضع إعادة ترتيب بالسحب والإفلات يعرض مؤشرات الموضع. يتيح نظام التصنيفات (Games وMedia وPrograms وOther افتراضياً) التصفية والتعيين السريع؛ ويمكن إضافة التصنيفات أو تحريرها أو حذفها بأيقونات وألوان مخصّصة، ويمكن اختيار تصنيف افتراضي عند التشغيل. الأعمال الفنية والمظهر يُجلب غلاف العمل الفني تلقائياً من SteamGridDB باستخدام مفتاح API مجاني يوفّره المستخدم، مع خيار تنزيل يدوي للإدخالات الموجودة ودعم للصور المحلية المخصّصة. يمكن ضبط الخلفيات يدوياً، أو تدويرها تلقائياً من مجلد خلفيات، أو استبدالها بخلفيات فيديو متدفقة على نمط Projectivy Overflight: تُبثّ الفيديوهات من كتالوج JSON (رابط افتراضي أو مخصّص) بدلاً من تنزيلها، مع جودة قابلة للضبط (1080p، 1080p HDR، 4K، 4K HDR، تكيّفية)، وفاصل تدوير، ومفتاح كتم، ومرشّحات تصنيفات. يمكن إزاحة الواجهة الدوّارة عمودياً لإتاحة مساحة للفيديو، ويختفي شريط أزرار النظام السفلي تلقائياً حتى يتم الانتقال إليه. يعتمد تشغيل الفيديو على libmpv، وهو مضمّن على Windows ومثبّت على مستوى النظام على Linux. ميزات النظام تشمل الإعدادات مفاتيح تبديل مرئية، ونسخاً احتياطياً/استعادة للإعدادات، وإعادة تعيين ناعمة (مع الإبقاء على التطبيقات) مقابل إعادة تعيين كاملة، ومدقّق تحديثات يُشعر بالإصدارات الجديدة، ومدير تصنيفات، وأداة طقس تُضبط حسب المدينة، وإجراءات نظام لإعادة التشغيل أو السكون أو الإيقاف أو إغلاق المشغّل. ويقفل نظام الرقابة الأبوية المشغّل خلف رمز PIN. التثبيت والإعداد يُعالَج نظاما Windows وLinux عبر فروع/نصوص برمجية منفصلة. يمكن إجراء الإعداد يدوياً باستخدام بيئة افتراضية وrequirements.txt، أو عبر installer.bat / installer.sh، التي تنشئ البيئة وتثبّت التبعيات وتوفّر نصوص تشغيل بنقرة واحدة. تتوفّر إصدارات محمولة لكلا النظامين؛ فإصدار Windows مجلد قائم بذاته، بينما تجمع أرشيف Linux المحمول وقت تشغيل Python وحزمه وQt6 مع دعم XCB/Wayland. توجد ملفات الإعداد (launcher_apps.json وkey_mappings.json وscanner_cache.json) وصور البلاطات في %APPDATA%\Roaming\TVLauncher على Windows و~/.config/TVLauncher على Linux، لذا تبقى بيانات المستخدم بعد التحديثات. وتُقدَّم تعليمات التشغيل التلقائي على Windows (مجلد Startup أو السجل) وعلى Linux (مدخل سطح مكتب في ~/.config/autostart). تشمل التبعيات PyQt6 وpsutil وpygame وrequests وpython-mpv، وعلى Windows أيضاً pycaw وpywin32. المشروع مرخّص بموجب MIT، مع ملاحظات لاستكشاف الأخطاء المتعلقة بأذونات أذرع التحكم، وغياب libmpv، وحزم منصة/وسائط Qt، وتنزيلات الصور، وتشغيل التطبيقات، والتخزين المؤقت للماسح.