عن المشروع

Textream هو تلقين مجاني ومفتوح المصدر مصمم لأجهزة Mac وiPhone وiPad، ويستهدف القائمين على البث المباشر والمحاورين والمقدمين ومنتجي البودكاست. يوفر ثلاثة أوضاع للقراءة: تتبع الكلمات (يبرز كل كلمة أثناء نطقها)، والكلاسيكي (تمرير تلقائي بسرعة ثابتة)، والتفعيل الصوتي (يمرر أثناء حديثك). يعرض تطبيق Mac النص في تراكب بأسلوب Dynamic Island، أو نافذة عائمة قابلة للسحب، أو ملء الشاشة على iPad عبر Sidecar. يضيف تطبيق iOS قراءة قريبة من الكاميرا وتسجيل كاميرا للمقدم فقط. تشمل الميزات الرئيسية: - **وضع المرآة** لزجاج التلقين، حيث يقلب النص أفقيًا أو رأسيًا أو كليهما في الاتجاه الأفقي، مع زر مضغوط للتحكم المباشر في المرآة والموضع وحجم النص والسرعة والتشغيل. - **موضع قراءة يحافظ على التواصل البصري** — يقع السطر النشط أسفل الكاميرا الأمامية مباشرة افتراضيًا، أو يمكن توسيطه. - **كاميرا اختيارية أثناء القراءة** — إظهار أو إخفاء الكاميرا خلف النص. - **تسجيل فيديو سيلفي** — يلتقط فيديو الكاميرا وصوت الميكروفون، مع تبديل بين الكاميرا الأمامية والخلفية، ويُحفظ في الصور مع معرض للتسجيلات. - **تلقين للمقدم فقط** — يكون النص المتحرك مرئيًا على الشاشة لكنه لا يُدمج في الفيديو المحفوظ. - **خطوط متطابقة** — Sans وSerif وMono وOpenDyslexic على كلا المنصتين. - **التعرف على الكلام** — على الجهاز أو بمعالجة Apple حسب جهاز Mac واللغة وتوفر النظام؛ لا حاجة للميكروفون في الوضع الكلاسيكي. - **خيارات العرض** — مثبت على النوتش، أو نافذة عائمة، أو ملء الشاشة على شاشة محددة؛ ارتفاع منطقة النص قابل للتعديل (100–400 بكسل) وأحجام خطوط من XS إلى XL. - **الإخفاء من مشاركة الشاشة** — يمنع ظهور التراكب في تسجيلات الشاشة أو مكالمات الفيديو. - **الاتصال عن بُعد** — عرض التلقين على أي جهاز عبر متصفح على الشبكة المحلية (HTTP + WebSocket)، مع وصول برمز QR ومزامنة فورية وعدم الحاجة لتطبيق على الجهاز البعيد. - **وضع المخرج** — يمكن للمخرج كتابة النصوص وتحريرها ودفعها في الوقت الفعلي من أي متصفح، مع خادم HTTP + WebSocket مخصص (المنفذ الافتراضي 7575)، وتحرير نص مباشر، وتمييز مقروء مقفل، وبث حالة فوري بمعدل 10 هرتز. - **استيراد ملاحظات PowerPoint** — إسقاط ملف .pptx لاستخراج ملاحظات المقدم كصفحات. - **دعم متعدد الصفحات** — التنقل بين الصفحات مع تقدم تلقائي. - **موجة صوتية مباشرة** — مؤشر بصري لنشاط الصوت. - **الخصوصية** — لا حسابات ولا إعلانات ولا تحليلات ولا خدمة سحابية تديرها Textream؛ قد يرسل التعرف على الكلام الصوت إلى Apple للمعالجة (انظر سياسة الخصوصية). - **مفتوح المصدر** — مرخص بموجب MIT. للمطورين، تعرض واجهة برمجة تطبيقات وضع المخرج خادم HTTP وخادم WebSocket على الشبكة المحلية. تُقدم واجهة الويب المدمجة على `http://<mac-ip>:<http-port>`، ونقطة نهاية WebSocket على `ws://<mac-ip>:<ws-port>`. تتطلب المصادقة رمزًا مكونًا من 64 حرفًا يُستخرج من HTML صفحة المخرج. يرسل العملاء رسائل JSON مثل `{"type":"auth","text":"<token>"}` خلال خمس ثوانٍ من الاتصال. تشمل الأوامر `start` (يستبدل النص ويبدأ تتبع الكلمات)، و`updateText` (يحرر النص غير المقروء مع الحفاظ على موضع القراءة)، و`stop`. يبث الخادم إطارات الحالة كل ~100 مللي ثانية بحقول مثل `words` و`highlightedCharCount` و`totalCharCount` و`fontColor` و`cueColor` و`audioLevels`. يتوفر مثال عميل Python بسيط في README. يتطلب البناء من المصدر Xcode 26 أو أحدث، مع استخدام هدف macOS لوضع لغة Swift 5. لنظام iOS، تحتاج إلى SDK iOS 26 وبيئة تشغيل المحاكي، بالإضافة إلى جهاز فعلي للتحقق من الكاميرا والميكروفون والتسجيل والحفظ في الصور. استنسخ المستودع، وافتح `Textream/Textream.xcodeproj`، واختر المخطط المناسب (Textream لنظام macOS، وTextreamiOS لنظام iOS)، وشغّل باستخدام ⌘R. لنظام iOS، قد تحتاج إلى تغيير معرف الحزمة إذا كان `dev.fka.textream` غير متاح، وتمكين وضع المطور على الجهاز. يسجل التطبيق أيضًا مخطط URL `textream://read?text=...` وخدمة macOS، مما يسمح بإرسال النص المحدد في أي تطبيق إلى Textream. تُنسب الفكرة الأصلية إلى Semih Kışlar، والتطبيق من صنع Fatih Kadir Akin. تتوفر صفحات الخصوصية والدعم على textream.net.