Prism Desktop: واجهة سطح مكتب أنيقة للتحكم في Home Assistant على ويندوز ولينكس

مشكلة متصفحات المنزل الذكي

أتمتة المنزل أصبحت جزءاً من حياتنا اليومية، لكن الوصول إلى Home Assistant عبر المتصفح ليس مثالياً. تحتاج إلى فتح علامة تبويب جديدة، تذكر عنوان IP أو اسم المضيف، تتعامل مع إعادة تحميل الصفحة، وتضيع مساحة من شاشتك على أزرار المتصفح بدلاً من عناصر التحكم في منزلك. التطبيقات الرسمية موجودة على الهواتف، لكن على سطح المكتب، الحل الوحيد كان المتصفح.

Prism Desktop جاء لملء هذه الفجوة. تطبيق سطح مكتب مستقل، خفيف، يعيش في علبة النظام، ويعطيك وصولاً فورياً إلى منزلك الذكي دون فتح متصفح واحد.

🔗 المستودع الرسمي: github.com/lasselian/Prism-Desktop 🔗 صفحة الإصدارات: github.com/lasselian/Prism-Desktop/releases

ما هو Prism Desktop؟

Prism Desktop هو تطبيق عميل لـ Home Assistant مبني على WebSocket API، مما يعني أنه يتزامن مع حالتك في الوقت الفعلي دون تأخير. عندما تشغل ضوءاً من هاتفك، يظهر فوراً في التطبيق على حاسوبك. عندما تغير درجة حرارة منظم الحرارة من التطبيق، ترى التحديث فوراً. لا حاجة لتحديث الصفحة يدوياً أبداً.

التطبيق يعيش في علبة النظام (System Tray) على ويندوز ولينكس (مع دعم AppIndicator على جنوم). يمكنك إظهاره عند الحاجة، وإخفاؤه عندما لا تحتاج إليه. لا يأخذ مساحة من شريط المهام، ولا يظهر في Alt+Tab إلا إذا أردت ذلك.

الميزات الرئيسية

علبة النظام والإشعارات

التطبيق لا يظهر كنافذة عادية على سطح المكتب إلا عندما تطلبه. بقية الوقت، هو أيقونة صغيرة في علبة النظام. عندما يرسل Home Assistant إشعاراً (مثل باب الثلاجة مفتوح، أو مجس الحركة اكتشف حركة)، يظهر إشعار سطح مكتب حقيقي على نظام التشغيل الخاص بك.

عناصر تحكم متحركة

واحدة من أذكى ميزات Prism Desktop هي “عناصر التحكم المتحركة” (Morphing Controls). عند النقر بالضغط مع الاستمرار على بلاطة (tile) بسيطة مثل مفتاح الإضاءة، تتوسع إلى عناصر تحكم دقيقة: يمكنك ضبط السطوع إذا كانت الإضاءة قابلة للتعتيم، أو ضبط درجة الحرارة إذا كان العنصر منظم حرارة.

لوحة تحكم قابلة للسحب والإفلات

يمكنك إعادة ترتيب البلاطات بحرية عن طريق سحبها وإفلاتها في الشبكة. لا حاجة للذهاب إلى إعدادات Home Assistant وتعديل ملف YAML. كل شيء يتم بالماوس.

تحجيم مرن للوحة التحكم

يمكنك تغيير حجم نافذة التطبيق، وتتكيف الشبكة داخلها تلقائياً. إذا كنت تريد لوحة تحكم صغيرة تطفو فوق النوافذ الأخرى، أو نافذة كبيرة تغطي نصف الشاشة، الخيار لك.

تخصيص المظهر

يدعم التطبيق تأثيرات حدودية مثل قوس قزح (Rainbow) والشفق القطبي (Aurora). يمكنك تخصيص ألوان الأزرار لتتناسب مع ديكور منزلك أو حالتك المزاجية.

اختصارات لوحة المفاتيح

يمكنك ربط اختصار عالمي (Global Shortcut) لإظهار أو إخفاء نافذة التطبيق من أي مكان، حتى عندما يكون التطبيق في الخلفية. أيضاً، يمكن ربط اختصارات فردية لأي بلاطة زر في لوحة التحكم.

الكيانات المدعومة

Prism Desktop يدعم مجموعة واسعة من كيانات Home Assistant:

بلاطة مخصصة للطابعة ثلاثية الأبعاد

لدعم مجتمع الطباعة ثلاثية الأبعاد، يحتوي التطبيق على بلاطة مخصصة لمراقبة الطابعة. تعرض كاميرا حية (إذا كانت متصلة)، درجة حرارة الفوهة (Nozzle) والهدف، درجة حرارة السرير (Bed) والهدف، وحالة الطباعة.

التثبيت

على ويندوز

حمّل ملف PrismDesktopSetup.exe من صفحة الإصدارات. شغّل المثبت، ويمكنك تفعيل خيار بدء التشغيل مع ويندوز. إذا كنت تفضل النسخة المحمولة (portable)، حمّل الملف المستقل .exe وضعـه في أي مجلد. كل الإعدادات تُحفظ في نفس المجلد.

على لينكس

حمّل ملف .AppImage من صفحة الإصدارات.

chmod +x PrismDesktop-x86_64.AppImage
./PrismDesktop-x86_64.AppImage

على أوبونتو 22.04 أو أحدث، قد تحتاج إلى تثبيت libfuse2:

sudo apt install libfuse2

على بيئة سطح المكتب GNOME، تحتاج إلى تثبيت إضافة “AppIndicator and KStatusNotifierItem Support” عبر Extension Manager لدعم أيقونات علبة النظام. على Wayland، يمكن ربط اختصار مخصص في إعدادات النظام لتبديل التطبيق:

/path/to/PrismDesktop-x86_64.AppImage --toggle

اختصارات الكيانات الفردية غير مدعومة على GNOME Wayland.

على KDE Plasma، كل شيء يعمل مباشرة بدون إضافات.

عبر Nix (باستخدام flakes)

تشغيل مباشر دون تثبيت:

nix run github:lasselian/prism-desktop

إضافة إلى الملف الشخصي:

nix profile add github:lasselian/prism-desktop#default

الإعداد الأول

عند التشغيل الأول، سيطلب منك التطبيق:

عنوان URL الخاص بـ Home Assistant (مثلاً http://homeassistant.local:8123). رمز وصول طويل الأجل (Long-Lived Access Token). يمكنك توليد واحد من حسابك في Home Assistant تحت Security → Long-Lived Access Tokens.

بعد إدخال هاتين المعلومتين، يقوم التطبيق بالاتصال بخادم Home Assistant الخاص بك، ويبدأ في تحميل الكيانات وعرضها في لوحة التحكم.

البناء من المصدر

للمطورين الذين يريدون بناء التطبيق بأنفسهم:

git clone https://github.com/lasselian/prism-desktop.git
cd prism-desktop
pip install -r requirements.txt
python main.py

لبناء حزمة Windows القابلة للتوزيع:

python build_exe.py

لبناء AppImage للينكس:

python3 build_linux.py

استكشاف الأخطاء وإصلاحها

إذا ظهر الخطأ WS Error: 400 – Duplicate 'Server' header found، فهذا يعني أن الوكيل العكسي (reverse proxy) الذي تستخدمه مع Home Assistant يضيف رأس Server مكرراً. الإصلاح يعتمد على نوع الوكيل:

على Caddy، أضف header_up -Server إلى كتلة reverse_proxy. على الوكالات الأخرى، ابحث عن خيار “إزالة رأس المنبع” (remove upstream header).

الخلاصة

Prism Desktop ليس تطبيقاً ثورياً من ناحية الميزات، لكنه يحل مشكلة حقيقية بسيطرة واحترافية. إذا كنت تستخدم Home Assistant وتقضي وقتاً طويلاً أمام حاسوبك، فإن وجود تطبيق سطح مكتب مخصص أفضل بكثير من علامة تبويب متصفح. التطبيق خفيف، سريع، متوافق مع ويندوز ولينكس، ومفتوح المصدر بالكامل تحت رخصة MIT.

إذا كنت تبحث عن طريقة أكثر أناقة للتحكم في منزلك الذكي من حاسوبك، جرب Prism Desktop.

روابط سريعة

https://github.com/lasselian/Prism-Desktop

https://github.com/lasselian/Prism-Desktop/releases

https://www.home-assistant.io