عن المشروع

# ويليس ويليس هو تطبيق مفتوح المصدر يحوّل جهازك اللوحي أو هاتفك الذكي إلى لوحة رسومية أو شاشة لمس لحاسوبك. يعمل على جميع أنظمة التشغيل الرئيسية (لينكس، ماك، ويندوز) ويتطلب فقط متصفحًا حديثًا على الجهاز اللوحي (فايرفوكس 80+، آي أو إس/آيباد أو إس 13+). ## الميزات الرئيسية - **التحكم بالماوس**: استخدم جهازك اللوحي للتحكم بمؤشر الماوس على الحاسوب - **عكس الشاشة**: عكس شاشة الحاسوب إلى الجهاز اللوحي في الوقت الفعلي - **إدخال لوحة المفاتيح**: قم بتوصيل لوحة مفاتيح بلوتوث بالجهاز اللوحي واكتب مباشرة - **تسريع الأجهزة**: يستخدم ترميز فيديو مسرّع بوحدة معالجة الرسومات (VAAPI على لينكس، NVENC/MediaFoundation على ويندوز، VideoToolbox على ماك) - **دعم القلم (لينكس)**: حساسية كاملة للضغط والإمالة لإدخال القلم - **اللمس المتعدد (لينكس)**: يدعم إيماءات اللمس المتعدد في البرامج المتوافقة مثل كريتا - **التقاط النوافذ (لينكس)**: حدد نوافذ معينة لعكسها والرسم عليها فقط - **الشاشة الثانية (لينكس)**: استخدم جهازك اللوحي كشاشة افتراضية إضافية ## التثبيت احصل على أحدث إصدار من [صفحة الإصدارات](https://github.com/H-M-H/Weylus/releases) لنظام التشغيل الخاص بك. لا حاجة للتثبيت على الجهاز اللوحي—فقط افتح متصفحًا. حزم AUR متاحة لمستخدمي أرش لينكس: - من المصدر: `weylus` - ثنائي مُجمّع مسبقًا: `weylus-bin` ## البدء السريع 1. ابدأ ويليس، عيّن رمز وصول (موصى به)، واضغط بدء 2. افتح الرابط المعروض (مثل `http://<عنوان-الحاسوب>:1701`) على جهازك اللوحي 3. اسمح بوصول جدار الحماية للمنافذ TCP 1701 (خادم الويب) و9001 (ويب سوكيت) ## ملاحظات خاصة بالمنصة ### لينكس - يتطلب `uinput` لدعم القلم واللمس المتعدد. اتبع إرشادات الإعداد في ملف README لإنشاء قاعدة udev. - دعم وايلاند تجريبي؛ يتطلب `pipewire` و`xdg-desktop-portal` ونهاية خلفية للبوابة (GTK لـ GNOME، KDE لـ KDE). - تسريع الأجهزة عبر VAAPI؛ قد تحتاج لتعيين `WEYLUS_VAAPI_DEVICE` إلى عقدة عرض (مثل `/dev/dri/renderD129`). - يمكن إنشاء شاشات افتراضية باستخدام برنامج تشغيل Intel `xf86-video-intel` لوظيفة الشاشة الثانية. ### ماك - يستخدم VideoToolbox لتسريع الأجهزة، على الرغم من أن الجودة قد تكون أقل من الترميز البرمجي. ### ويندوز - يدعم NVENC وMediaFoundation للترميز المسرّع بالأجهزة. ## البناء من المصدر يتطلب Rust وTypeScript وmake وgit ومترجم C وnasm وbash. على لينكس، هناك حاجة لتبعيات إضافية (انظر README للقائمة الكاملة). يقوم سكربت البناء بتجميع ffmpeg وlibx264 افتراضيًا؛ يمكنك استخدام مكتبات النظام مع `--features ffmpeg-system`. البناء عبر دوكر مدعوم أيضًا عبر صورة `hhmhh/weylus_build`. ## كيف يعمل يستخدم ويليس أحداث PointerEvents في المتصفح لالتقاط إدخال القلم واللمس والماوس من الجهاز اللوحي. تُرسل هذه الأحداث عبر ويب سوكيت إلى الخادم، الذي يعالجها باستخدام إما نهاية خلفية عامة (ماوس فقط) أو، على لينكس، نهاية uinput الخلفية لدعم كامل للقلم واللمس المتعدد. يستخدم عكس الشاشة ffmpeg لترميز سطح المكتب (أو النوافذ المحددة) إلى دفق فيديو H.264، يُشغَّل في المتصفح عبر Media Source Extensions. ## أبرز الأسئلة الشائعة - **مشاكل الاتصال؟** تأكد من فتح منافذ TCP (1701 و9001) في جدار الحماية. - **لا يوجد التقاط نوافذ على ماك/ويندوز؟** هذه الميزة خاصة بلينكس بسبب تكامل X11. - **فايرفوكس لأندرويد لا يعمل؟** استخدم متصفحًا آخر أو تحقق من إعدادات الشبكة. - **مشاكل كروم على آيباد؟** يفتقر كروم لبعض ميزات بث الفيديو على آيباد أو إس؛ استخدم سفاري أو فايرفوكس. - **لا واي فاي؟** استخدم مشاركة USB أو أنشئ نقطة اتصال من جهازك اللوحي. يمكن لمستخدمي أندرويد استخدام إعادة توجيه منافذ ADB للاتصال عبر `http://127.0.0.1:1701`. ## ملاحظة أمنية لا يحتوي ويليس على تشفير مدمج لتقليل زمن الاستجابة. شغّله فقط على شبكات موثوقة. للشبكات غير الموثوقة، قم بإعداد وكيل TLS (مثل hitch) كما هو موضح في README. للتفاصيل الكاملة، بما في ذلك استكشاف الأخطاء والإصلاح والإعداد المتقدم، راجع [README الرسمي](https://github.com/H-M-H/Weylus).