_{26.10.09 14:52}

FastMediaSorter v2 🚀

📦 تنزيل:

هل تُثبّت ملف APK مباشرة؟ يُحذّرك Android من حزمة لم يسبق له رؤيتها من قبل - لماذا يظهر التحذير، وماذا تنقر.

📘 وثائق المستخدم: أدلة خطوة بخطوة لكل ميزة، مع بحث

نبذة عن المشروع

FastMediaSorter v2 هو غلاف كامل لجهاز Android. فهو يتولى الشاشة الرئيسية، ويشغّل وسائطك، ويفتح البث المباشر، ويطلق تطبيقاتك، ويتواصل مع ساعتك الذكية، ويراقب الجهاز، ويدير كل ملف تملكه - في المجلدات المحلية، وعلى محركات الشبكة (SMB وSFTP وFTP)، وفي التخزين السحابي (Google Drive وOneDrive وDropbox).

يقوم على ثماني ركائز: غلاف الجهاز، ومشغّل الوسائط، والبث المباشر، وإطلاق التطبيقات، وبديل لتطبيقات النظام الافتراضية، ورفيق على الساعة، ومراقبة الجهاز، ومدير ملفات كامل. بدأ التطبيق من فرز الملفات عبر كل هذه المصادر، وما زال ذلك هو الأساس الذي يُبنى عليه الباقي - لكنه لم يعد كل ما يقدّمه.

يتبع هذا الدليل الآن المصطلحات العامة نفسها المستخدمة في جرد الميزات المرجعي في FEATURES.md وخريطة الوثائق في DOCS_MAP.md. استخدم هاتين الصفحتين كمصدر الحقيقة الحالي لقصة التطبيق والإصدارات المتاحة ونطاق الميزات الحالي.

نسخة Windows 🖥️

تبحث عن حل لسطح المكتب؟ جرّب Fast Media Sorter & Sharing for Windows - تطبيق Windows Forms خفيف لفرز ملفات الصور والفيديو وعرضها وإدارتها بسرعة:

🔗 Fast Media Sorter & Sharing for Windows

📄 كيفية نشر مجلدات الكمبيوتر إلى Android - شارك مجلدات الكمبيوتر مع التطبيق عبر SFTP (استيراد عبر المرافق / مسح رمز QR على الهاتف).

تشمل الميزات:

• تصفح سريع عبر مجلدات كبيرة من الصور والفيديوهات
• أوضاع عرض الشرائح والعرض العشوائي للملفات
• تتبع الملفات والمجلدات الأخيرة
• عمليات الملفات: نقل ونسخ وإعادة تسمية وحذف
• لوحة صور للتنقل البصري السريع
• اختصارات لوحة مفاتيح قابلة للتخصيص لسير عمل فعّال
• دعم متعدد اللغات (الإنجليزية/الروسية)
• يدعم Windows 7/10/11 مع .NET Framework 4.8

جدول المحتويات

• تنزيل
• الإصدارات
• الميزات الرئيسية
• صيغ الوسائط المدعومة
• لقطات الشاشة
• سيناريوهات الاستخدام
• الوثائق
• رفيق Wear OS
• تعليمات البناء
• الاختبار
• الخطوات الأولى
• حزمة التقنيات

الإصدارات 🎯

يوفر FastMediaSorter v2 سبعة إصدارات - خمسة للهواتف والأجهزة اللوحية اليومية (Standard وLite وPhotos وLegacy وFOSS) بالإضافة إلى إصدارين لسماعات الرأس والتثبيت الجانبي، هما VR وnoLegal. جدول القدرات المرجعي يُنشأ تلقائيًا من عملية البناء في FLAVOR_MATRIX.md:

الإصدار	الوصف	ملاحظات
Standard	إصدار كامل الميزات	أوسع مجموعة ميزات للوسائط والمستندات والتعرف الضوئي (OCR) والترجمة والوصول السحابي
Lite	إصدار خفيف	ملفات محلية فقط - فيديو وصوت وصور؛ بلا مصادر شبكة أو سحابة أو مستندات أو بث (Streams)
Photos	إصدار يركّز على الصور	صور فقط، مع SMB/FTP/SFTP والسحابة؛ بلا فيديو وبلا صوت
Legacy	إصدار يركّز على التوافق	نفس مجموعة ميزات Standard، بما في ذلك SMB/FTP/SFTP والسحابة (Google Drive وDropbox وOneDrive)؛ مصمم لأجهزة Android 6/7 (API 23+)
FOSS	إصدار كتالوج F-Droid	بلا حزم SDK مملوكة: وسائط محلية ومستندات وEPUB وSMB/FTP/SFTP؛ بلا سحابة وبلا بث (Streams) وبلا OCR وبلا ترجمة وبلا Cast وبلا رفيق Wear OS
VR	إصدار سماعات رأس نظيف لمتاجر التطبيقات	مجموعة وسائط كاملة لسماعات الرأس؛ بلا Google Cast وبلا رفيق Wear OS
noLegal	إصدار للتثبيت الجانبي	كل ما في Standard بالإضافة إلى مشغّل OpenXR الغامر وإضافات خاصة بالتثبيت الجانبي فقط

أي إصدار يجب أن أنزّله؟

• Standard ⭐ (موصى به): الخيار الافتراضي الأفضل لمعظم المستخدمين
• Lite: اختره إذا كنت تريد حزمة أخف وإعدادًا أبسط
• Photos: اختره لسير عمل يركّز على الصور أولًا
• Legacy: اختره لأجهزة Android 6/7 (API 23+) - يشمل الشبكة والسحابة
• FOSS: اختره من كتالوج F-Droid عندما تريد إصدارًا خاليًا من حزم SDK المملوكة
• VR: اختره لسماعة رأس XR - إصدار المتجر بلا دعم Cast وWear
• noLegal: للتثبيت الجانبي فقط - اختره عندما تحتاج مشغّل OpenXR الغامر

للاطلاع على توفر الميزات الدقيق حسب الإصدار، استخدم الوثائق المرجعية:

• جرد الميزات (المرجعي)
• كيفية الاستخدام (جدول توفر الميزات)
• البدء السريع (مُحدِّد الإصدار)
• قيود البرنامج

🧭 عند أول تشغيل: أسفل مُنتقي اللغة مباشرة، يتيح لك التطبيق اختيار ملف تعريف للجهاز (هاتف، جهاز لوحي، تلفاز، سيارة، إطار صور، VR، والمزيد) يُهيّئ الإعدادات الافتراضية المبدئية لك - قابل للتغيير في أي وقت من الإعدادات. راجع عند أول تشغيل: اختر ملف تعريف جهازك.

تنزيل 📥

📲 احصل عليه من Google Play

ملفات APK المُصرَّفة غير مخزَّنة في مستودع GitHub هذا. جميع الإصدارات متاحة على Google Drive:

🔗 تنزيل جميع الإصدارات من Google Drive

الإصدار	اسم الملف	الوصف
Standard	FastMediaSorter_standard_release.zip	ميزات كاملة (سحابة، OCR، EPUB، ترجمة)
Lite	FastMediaSorter_lite_release.zip	وسائط محلية فقط (فيديو، صوت، صور؛ بلا شبكة أو سحابة أو مستندات أو بث)
Photos	FastMediaSorter_photos_release.zip	صور فقط، مع الشبكة (SMB/FTP/SFTP) والسحابة
Legacy	FastMediaSorter_legacy_release.zip	نفس ميزات Standard، بما في ذلك الشبكة (SMB/FTP/SFTP) والسحابة؛ Android 6/7 (API 23+)

ملاحظة: تُرفع جميع الإصدارات تلقائيًا إلى Google Drive بعد نجاح التصريف.

🔐 كلمة مرور ZIP: 1 (ملفات APK مُعبأة كأرشيفات ZIP محمية بكلمة مرور لتجاوز قيود Google Drive)

لقطات الشاشة 📱

الشاشة الرئيسية	إجراءات الملفات	الإعدادات
عرض المشغّل

صور بالحجم الكامل:

• الشاشة الرئيسية
• إجراءات الملفات
• الإعدادات
• عرض المشغّل

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

• 🗂️ واجهة موحدة: اعرض الملفات من جميع المصادر وأدرها في نافذة واحدة.
• ⚡ فرز سريع: انسخ الملفات أو انقلها إلى مجلدات وجهة مُعدّة مسبقًا بنقرة واحدة.
• ⭐ نظام المفضلة: ضع علامة على الملفات المهمة كمفضلة وصِل إليها بسرعة من علامة تبويب مخصّصة تجمع المفضلة من جميع المصادر.
• 🔒 حماية برمز PIN: أمّن كل مورد على حدة برمز PIN للوصول لمنع التصفح والتعديل غير المصرّح بهما.
• ⚙️ إعدادات لكل مورد: خصّص فاصل عرض الشرائح، وعمق الفحص (المجلدات الفرعية)، وإنشاء الصور المصغّرة لكل مجلد على حدة.
• 🧭 إعداد ملف تعريف الجهاز: اختر ملف تعريف عند أول تشغيل للهواتف أو الأجهزة اللوحية أو صناديق التلفاز/الوسائط أو وحدات رأس السيارة أو مشغلات الوسائط أو إطارات الصور أو مشغلات الصوت أو قارئات الكتب الإلكترونية أو سماعات VR أو إعدادات مخصّصة؛ يطبّق التطبيق الإعدادات الافتراضية المطابقة للأمان والشاشة والمحتوى وأولوية الأوامر.
• 📋 موارد ذكية مُعدّة مسبقًا: موارد افتراضية مدمجة - كل الموسيقى وكل الفيديوهات وكل الصور - تجمع الوسائط من جهازك بالكامل دون أي إعداد. صِل فورًا إلى مكتبة الوسائط الكاملة دون إضافة المجلدات يدويًا واحدًا تلو الآخر.
• 🖥️ دعم الشبكة والسحابة: اعمل مع الملفات على محركات الشبكة (SMB مع فحص تلقائي للشبكة)، وخوادم SFTP، وFTP، وفي التخزين السحابي (Google Drive وDropbox وOneDrive).
• 🖼️ عرض مرن: اعرض الملفات كشبكة قابلة للتخصيص أو كقائمة تفصيلية مع دعم التقسيم إلى صفحات للمجموعات الكبيرة (أكثر من 1000 ملف).
• ▶️ مشغّل مدمج: تشغيل الفيديو والصوت، وعرض الصور وGIF دون مغادرة التطبيق. يدعم عرض الشرائح والتكبير بملء الشاشة.
• 🧩 تكامل كمشغّل افتراضي: مفاتيح تشغيل اختيارية تتيح لـ FastMediaSorter العمل كمُعالِج وسائط للنظام لأغراض الفتح/المشاركة (ACTION_VIEW / ACTION_SEND)، وتوجيه أحداث تنشيط أزرار الوسائط الفعلية إلى خدمة تشغيل الصوت.
• 🗣️ وظائف تطبيق للمساعد (Android 16+): يُعلن التطبيق عن إجراءات يمكن لمساعد النظام استدعاؤها - البحث في وسائطك، أو فتح ملف، أو فتح مجلد كمبيوتر - بحيث يستطيع مساعد نظام جهازك إيجاد محتواك وفتحه بمجرد أن تطلب ذلك.
• 🎛️ دعم الأزرار الفعلية: أزرار مقود السيارة، وأزرار سماعة الرأس، ومفاتيح الوسائط الفعلية (تشغيل/إيقاف مؤقت، التالي، السابق) مدعومة بالكامل عبر خدمة تشغيل الصوت في الخلفية - دون الحاجة إلى التفاعل مع الشاشة.
• 📻 البث عبر الإنترنت (شاشة البث): شغّل راديو الإنترنت (http/https، وIcecast/Shoutcast مع معلومات ICY للمقطوعة الحالية)، وبث HLS/DASH، ومصادر RTSP مباشرة من شاشة بث مخصّصة. أضف الروابط يدويًا، أو استورد قائمة تشغيل .m3u، أو نزّل كتالوجًا منسّقًا من FastMediaSorter. ثبّت المفضلة في الأعلى؛ وصفِّ حسب الفئة واللغة. صوت ضمن القائمة: يُشغَّل الراديو من القائمة عبر تحكّم مصغّر ثابت أسفل الشاشة بينما تبقى القائمة قابلة للتمرير. يفتح الفيديو وRTSP في المشغّل بملء الشاشة. متاح في Standard وLegacy وVR وnoLegal؛ غير متوفر في Lite وPhotos.
• 🎵 دعم كلمات الأغاني: اعرض كلمات الأغنية للمقطوعة قيد التشغيل حاليًا. يبحث تلقائيًا باستخدام البيانات الوصفية (الفنان/العنوان) عبر api.lyrics.ovh، مع الرجوع إلى تحليل اسم الملف عند الفشل.
• 🎶 موسيقى خلفية لعرض الشرائح: شغّل موسيقى خلفية أثناء عرض شرائح الصور. اختر أي مورد صوتي كمصدر لموسيقاك، مع تشغيل عشوائي للمقطوعات، والتحكم في مستوى الصوت، وعرض اسم المقطوعة. اضغط على اسم المقطوعة للتخطي إلى مقطوعة عشوائية أخرى. يعمل بسلاسة مع ملفات الشبكة والسحابة.
• ✏️ تحرير الصور: دوّر واقلب وطبّق المرشحات (تدرج رمادي، بني داكن، سلبي)، واضبط السطوع/التباين/التشبع - للملفات المحلية وملفات الشبكة على حد سواء.
• 🗂️ دعم الملفات الثنائية: اعرض الملفات الثنائية (ZIP، RAR، APK، ISO، EXE، DLL، وغيرها) وأدرها بصور مصغّرة مُنشأة تُظهر امتداد الملف. قائمة سياقية بخيارات المشاركة/الفتح باستخدام/النسخ/النقل/إعادة التسمية/الحذف. متاح فقط في “وضع كل الملفات”.
• ⌨️ لوحة المفاتيح والفأرة ووحدة التحكم: إدخال كامل بلوحة المفاتيح والفأرة ووحدة التحكم عبر جميع الشاشات - التصفح، والمشغّل، والإعدادات، ومربعات الحوار. قابل لإعادة التخصيص بالكامل عبر الإعدادات ← الإدارة ← أدوات التحكم واختصارات المفاتيح؛ اضغط F1 في أي شاشة لعرض تراكب مساعدة خاص بتلك الشاشة. تنقل بالقائمة عبر مفاتيح الاتجاهات (D-pad)؛ قائمة سياقية بالزر الأيمن وتأثيرات التمرير للفأرة.
• 🔍 الفرز والتصفية: رتّب الملفات حسب الاسم والتاريخ والحجم والمدة. طبّق مرشحات للبحث السريع. دعم للملفات المخفية (التي تبدأ بـ .) بمفتاح تبديل مخصّص.
• ↩️ التراجع وسلة المهملات: إمكانية التراجع عن آخر إجراء (نسخ، نقل، حذف) مع حذف ناعم إلى مجلد .trash/. يتضمن وظيفة “إفراغ سلة المهملات” لكل مورد.
• 🎨 واجهة حديثة: دعم للسمات الفاتحة والداكنة، وعناصر تحكم بديهية، وMaterial Design 3.
• 💾 تخزين مؤقت ذكي: تحميل بيانات الفيديو الوصفية على مرحلتين (1 ميجابايت مبدئيًا، و5 ميجابايت موسّعة) وذاكرة تخزين مؤقت للصور المصغّرة قابلة للتهيئة (2 جيجابايت افتراضيًا، حتى 16 جيجابايت).
• 📄 عارض المستندات: عارض مدمج لملفات النصوص (.txt، .md، .log، .json، .xml) ومستندات PDF مع التكبير والتحريك والتنقل بالإيماءات.
• 📚 قارئ كتب EPUB الإلكترونية: قارئ EPUB أصلي مع تنقل بين الفصول، وفهرس محتويات، والتحكم بحجم الخط، وبحث داخل الكتاب، ودعم للسمة الداكنة/الفاتحة. يعمل مع الملفات المحلية وملفات الشبكة.
• 📥 تنزيل وفتح: نزّل ملفات الشبكة (SMB/SFTP/FTP) إلى التخزين المحلي وافتحها في تطبيقات خارجية مع تتبع للتقدم.
• 🌐 ترجمة تلقائية: ترجم النص فورًا من الصور وملفات PDF والملفات النصية بالكامل على الجهاز: يقرأ Tesseract النص بالحروف اللاتينية والسيريلية، ثم يترجمه Google ML Kit. يعرض الترجمة إما نصًا منفصلًا أو كتلًا مرسومة فوق النص الأصلي مباشرة على الصورة.
• 📱 دعم الودجات: أكثر من اثني عشر ودجة للشاشة الرئيسية تغطي نطاقًا واسعًا - اختصارات الموارد، ومشغلات الوسائط، والتقاط الكاميرا، والآلات الحاسبة، والمهام المجدولة، والمفضلة، وألعاب مصغّرة، والمزيد. تصفّح المجموعة الكاملة في مُنتقي الودجات في مُطلق تطبيقاتك.
• 🏠 وضع الشاشة الرئيسية: اجعل التطبيق الشاشة الرئيسية لجهازك (إصدارا Standard وnoLegal): سطح مكتب خاص به باختصارات موارد تفتح مباشرة في التصفح أو عرض الشرائح أو التشغيل، وودجات قابلة لتغيير الحجم مثل الساعة والطقس، وخلايا جهات اتصال لا تحتاج إلى إذن الوصول لجهات الاتصال، وشبكة تطبيقات، وشريط مهام. أوقف تشغيله في أي وقت وسيستعيد Android شاشتك الرئيسية السابقة.
• ⏰ عمليات ملفات مجدولة: أتمتة عمليات الملفات (نسخ/نقل/حذف) باستخدام قواعد زمنية مع مرشحات مرنة وتنفيذ في الخلفية.
• 👆 إيماءات متقدمة: عناصر تحكم تكبير ذكية (2x/3x/4x) للصور ومناطق لمس بديهية للتنقل بين الملفات.
• 📸 حفظ الإطار: التقط إطار الفيديو الحالي كصورة PNG أو JPG واحفظه في أي مورد مُهيَّأ - محلي أو شبكي. تُحدَّد صيغة الإخراج والمورد الوجهة في إعدادات الفيديو.
• 🖨️ الطباعة: أرسل المستندات (PDF وTXT) والصور إلى طابعة مباشرة من المشغّل المدمج. تُخزَّن ملفات الشبكة والسحابة محليًا مؤقتًا قبل الطباعة.
• ⬇️ تفريغ البث: نزّل ملف شبكة إلى الذاكرة المؤقتة المحلية مع مربع حوار يعرض التقدم في الوقت الفعلي قبل التشغيل أو أثناءه. يعرض مربع حوار اختياري لتنظيف المساحة لاستعادة التخزين لاحقًا.
• 🔊 صوت DTS/DTS-HD: تُفكّ شفرة مسارات صوت DTS وDTS-HD برمجيًا عبر إصدار FFmpeg مخصّص - دون الحاجة إلى عتاد خاص.
• 🎨 لون الفيديو وسطوعه: اضبط درجة اللون (Hue) والسطوع في الوقت الفعلي باستخدام تأثيرات Media3 على معالج الرسوميات. تبقى الإعدادات ثابتة عبر ملفات الفيديو خلال الجلسة.
• 📤 مشاركة إلى FastMediaSorter: استقبل الملفات من أي تطبيق عبر ورقة المشاركة القياسية في Android وانسخها إلى مورد مختار بنقرة واحدة.
• 📷 التقاط بالكاميرا أثناء التصفح: التقط صورة بكاميرا الجهاز واحفظها مباشرة في المورد الحالي - محلي أو شبكي - دون مغادرة التطبيق.
• 🔗 تنزيل تلقائي للروابط: شارك أي رابط http(s) مع التطبيق عبر ورقة المشاركة في Android؛ يُنزَّل ملف الوسائط ويُحفظ في مورد مختار تلقائيًا.
• 👁️ وضع ثلاثي الأبعاد بعين واحدة: اقتصاص المحتوى المجسّم (SBS/OU) إلى عين واحدة للمشاهدة المريحة على الشاشات المسطحة؛ يعمل مع الفيديو والصور معًا.
• 📲 التقاط الشاشة وتسجيلها: شريط إيماءات من الحافة اليسرى لالتقاط الشاشة، والصور السريعة، والاقتصاص والمشاركة، وتسجيل الشاشة/الصوت/الفيديو دون مغادرة الملف الحالي.
• 📊 إحصاءات الاستخدام (اختيارية): لوحة معلومات محلية للملفات المُفرزة والمساحة المُحرَّرة ووقت التشغيل - لا يغادر شيء الجهاز إلا إذا صدّرته بنفسك.
• 🧹 إيجاد التكرارات وتنظيف حسب الحجم: فحص للتكرارات يعتمد على المحتوى (الحجم، وتجزئة سريعة، وSHA-256) مع حذف يدوي أو تلقائي، بالإضافة إلى تنظيف بالحذف حسب الحجم.

صيغ الوسائط المدعومة 🎞️

يدعم FastMediaSorter v2 مجموعة واسعة من الصيغ:

• الصور: JPG، JPEG، PNG، GIF، BMP، WEBP، HEIC، HEIF
• الفيديو: MP4، MKV، MOV، WMV، FLV، WEBM، M4V، 3GP، MPG، MPEG
• الصوت: MP3، FLAC، AAC، OGG، M4A، WMA، OPUS، DTS، DTS-HD
• المستندات: TXT، MD، LOG، JSON، XML، PDF، EPUB
• الملفات الثنائية (وضع كل الملفات): ZIP، RAR، 7z، TAR، GZ، ISO، DMG، IMG، APK، EXE، DLL، SO، وأكثر من 60 صيغة أخرى

سيناريوهات الاستخدام 💡

إليك بعض الطرق التي يمكن أن يساعدك بها FastMediaSorter v2:

1. 📸 تنظيم صور الكاميرا

وصّل هاتفك أو افتح مجلد كاميرا محليًا. أعدّ مجلد وجهة باسم “أفضل الصور”. افتح العارض، ومرّر بسرعة عبر آلاف الصور، واضغط زر الوجهة لنسخ أفضل اللقطات فورًا.

2. 🏠 نسخ احتياطي عبر الشبكة (NAS)

أضف جهاز NAS المنزلي عبر SMB. تصفّح ملفات الوسائط المحلية. اختر عدة ملفات أو نطاقًا، و”انقلها” إلى NAS لحفظها بأمان، وتحرير مساحة على جهازك.

3. ☁️ إدارة السحابة

اربط حساب Google Drive أو Dropbox أو OneDrive. تصفّح ملفاتك السحابية دون تنزيلها كلها. احذف الملفات غير المرغوبة أو نظّمها في مجلدات مباشرة في السحابة.

4. 📺 عرض الشرائح والتقديم

افتح مجلدًا يحتوي على صور عائلية أو شرائح تقديمية. اضغط “تشغيل” لبدء عرض الشرائح. استخدم إعدادات كل مورد لضبط مدة عرض الشريحة حسب رغبتك.

5. ⭐ إدارة المفضلة

ضع علامة على الملفات المهمة بزر النجمة أثناء التصفح. لاحقًا، اضغط علامة تبويب “المفضلة” في القائمة الرئيسية للوصول فورًا إلى جميع ملفاتك المفضلة من كل المصادر في مكان واحد - مثالي لإنشاء مجموعة منتقاة من أفضل وسائطك.

6. 🎶 عرض شرائح بموسيقى خلفية

أضف مجموعتك الموسيقية كمورد. في الإعدادات ← الوسائط ← الصور، فعّل “تشغيل موسيقى أثناء عرض الشرائح” واختر موردك الموسيقي. الآن عند بدء عرض شرائح لصورك، ستُشغَّل مقطوعاتك المفضلة في الخلفية. اضغط على اسم المقطوعة للتخطي إلى مقطوعة عشوائية أخرى، لخلق الأجواء المثالية لعروض صورك.

7. 🖼️ إطار صور رقمي على جهاز لوحي

حوّل أي جهاز لوحي يعمل بنظام Android إلى إطار صور رقمي جميل يعمل باستمرار. ضعه على حامل، واربطه بكمبيوتر منزلك (SMB) أو بالتخزين السحابي - تُبث الصور مباشرة دون شغل أي مساحة تخزين محلية. اضبط فاصل الشرائح، وأبقِ الشاشة مضاءة دائمًا، وأضف موسيقى خلفية، واستمتع بذكرياتك. حتى الأجهزة اللوحية الاقتصادية القديمة والبطيئة تعمل بشكل ممتاز لهذا الغرض - فالتطبيق مُحسَّن للتشغيل المستمر بموارد منخفضة.

8. 🍿 السينما المنزلية وVR

شاهد مسلسلاتك المفضلة المخزَّنة على كمبيوترك أو في السحابة مباشرة على هاتفك أو سماعة VR. لا حاجة لانتظار النسخ أو القلق بشأن المساحة الفارغة. فقط اضغط تشغيل، وستبدأ الحلقة التالية تلقائيًا.

حالات استخدام سماعة VR - يعمل FastMediaSorter بشكل أصلي على سماعات VR المبنية على Android (مثل Meta Quest وPico وما شابهها) دون أي تعديلات:

• 🎬 سينما افتراضية عملاقة: افتح فيديو من NAS المنزلي أو التخزين السحابي وشاهده على شاشة افتراضية بحجم حائط كامل. لا حاجة لنسخ ملفات بحجم غيغابايتات إلى السماعة - يبث التطبيق مباشرة عبر شبكتك المنزلية. عند انتهاء حلقة، تبدأ التالية تلقائيًا.
• 🎵 مشغّل موسيقى غامر: شغّل مجموعتك الموسيقية في بيئة VR. تُبقي خدمة تشغيل الصوت في الخلفية الموسيقى قيد التشغيل حتى عند التبديل بين التطبيقات أو فتح الشاشة الرئيسية لـ VR. تعمل أزرار السماعة الفعلية (تشغيل/إيقاف مؤقت، المقطوعة التالية) دون لمس وحدة التحكم.
• 🖼️ إطار صور VR بحجم حائط: حوّل سماعة VR إلى تجربة صور غامرة - ابدأ عرض شرائح وستملأ صورك حائطًا افتراضيًا ضخمًا حولك. اقرنها بموسيقى خلفية لتجربة ذكريات سينمائية تملأ الغرفة. ابث الصور مباشرة من كمبيوتر منزلك أو السحابة بحيث تبقى مساحة تخزين السماعة فارغة.

9. 🧹 منظّم التنزيلات

مجلد التنزيلات مزدحم؟ افتحه في لوحة المصادر، وأعدّ أزرار وجهة لـ”المستندات” و”الصور” و”برامج التثبيت”. امسح الملفات بسرعة، وعاينها، وافرزها إلى الأماكن الصحيحة بنقرة واحدة. يمكنك حتى فرز الملفات مباشرة على كمبيوتر شبكتك باستخدام هاتفك كجهاز تحكم عن بُعد.

10. 🚗 موسيقى داخل السيارة بوحدة رأس Android

ثبّت FastMediaSorter على مسجل السيارة أو وحدة الرأس التي تعمل بنظام Android. أضف مجلدات موسيقى من محرك USB أو بطاقة SD - أو استخدم المورد الافتراضي المدمج كل الموسيقى للوصول الفوري إلى مجموعتك الكاملة دون أي إعداد. تعمل أزرار الوسائط الفعلية (أزرار مقود السيارة، مقابض الصوت) بسلاسة عبر خدمة تشغيل الصوت في الخلفية: تشغيل/إيقاف مؤقت، المقطوعة التالية/السابقة، كل ذلك دون لمس الشاشة. يتذكر التطبيق موضع التشغيل ويستأنفه تلقائيًا عند بدء التشغيل.

مع تفعيل شاشة البث (Streams)، تشغّل وحدة الرأس نفسها أيضًا محطات راديو الإنترنت مباشرة عبر بيانات الهاتف المحمول أو Wi-Fi - دون الحاجة إلى تطبيق راديو منفصل. أضف أي رابط راديو، أو استورد كتالوج محطات منسّقًا من شاشة الإضافات. يعرض التحكّم المصغّر الثابت اسم المقطوعة الحالية عبر ICY بينما تبقى قائمة المحطات ظاهرة.

11. 📺 مركز وسائط على صندوق Android TV

ثبّت FastMediaSorter على أي صندوق Android TV (مثل Xiaomi Mi Box، وNvidia Shield، وAmazon Fire TV، أو صندوق Android عام). اتصل بـ NAS منزلي عبر SMB، وأضف Google Drive أو Dropbox، أو وصّل محرك USB - كل ذلك من تطبيق واحد. تحكّم بالتدفق الكامل بجهاز تحكم عن بعد أو لوحة مفاتيح Bluetooth: تنقل مفاتيح الاتجاهات (D-pad) التركيز، ويفتح OK العناصر، ويعيدك Back إلى المستوى السابق، ويصعد Backspace مجلدًا واحدًا للأعلى في المتصفح. تُطابق الأزرار الملوّنة في جهاز التحكم إجراءات ملفات شائعة (الأحمر = حذف، الأخضر = نسخ، الأصفر = نقل، الأزرق = إعادة تسمية). ابدأ عرض شرائح بملء الشاشة مع موسيقى خلفية على التلفاز، أو انتقل إلى تشغيل الصوت مع غلاف الألبوم وكلمات الأغنية. لا حاجة لشاشة لمس.

الوثائق 📚

🗺️ خريطة الوثائق: عرض كل الوثائق

🌐 الموقع الرسمي: https://serzhyale.github.io/FastMediaSorter_mob_v2/

المصادر المرجعية (المصدر الوحيد للحقيقة)

ينبغي التعامل مع الملفات التالية باعتبارها المصادر الموثوقة للتفاصيل التي يراها المستخدم:

• قائمة الميزات الكاملة
• خريطة الوثائق
• تاريخ المنتج
• التنزيلات (بالإنجليزية)
• أدلة كيفية الاستخدام
• قيود البرنامج
• دليل البدء السريع
• شروط الخدمة

الأدلة التفصيلية متوفرة بعدة لغات:

🇺🇸 English:

• Product History
• How-To Guides
• Launcher Web Portal
• Wear OS Web Portal
• Quick Start
• FAQ
• Troubleshooting
• Program Limitations
• Downloads Guide
• Complete Feature List

🇷🇺 Русский:

• История продукта
• Руководства
• Быстрый Старт
• FAQ
• Устранение неполадок
• Ограничения программы
• Скачивание сборок

🇺🇦 Українська:

• Історія продукту
• Посібники
• Швидкий Старт
• FAQ
• Вирішення проблем
• Обмеження програми
• Завантаження збірок

وثائق تقنية / للمطورين:

• نظرة عامة على البنية
• DevOps وسكربتات البناء
• حزمة التقنيات
• وثائق Wear OS
• مكوّنات المصدر المفتوح

رفيق Wear OS ⌚

يتضمن FastMediaSorter تطبيق Wear OS مستقلًا كامل الميزات ورفيقًا للهاتف مصمَّمين لشكل الساعات الذكية.

• تصفّح وشغّل المجلدات والمفضلة من الهاتف المقترن، ومن تخزين الساعة نفسها، ومن مشاركات SMB/FTP/SFTP التي تصل إليها الساعة مباشرة عبر Wi-Fi
• تبقى الموارد السحابية على الهاتف - فالساعة لا تملك عميل سحابة خاصًا بها؛ لا يصل الملف السحابي إليها إلا عند إرساله من الهاتف عبر “إرسال إلى..”
• انقل الملفات بين الهاتف والساعة، وابثّ مباشرة من الساعة، واستخدم أدوات صغيرة مدمجة (آلة حاسبة، ومراقب شبكة، ولعبة مصغّرة) دون فتح تطبيق الهاتف
• واجهة مستخدم وسلوك تشغيل مُحسَّنان للشاشات الدائرية والمدمجة
• بوابة ويب مخصّصة، وأدلة إعداد، واستكشاف أخطاء وإصلاحها لسير عمل الساعة

الوسائط ومشاركات الشبكة ونقل الملفات موجودة في النسخة الكاملة من تطبيق الساعة (APK مباشر). نسخة Google Play إصدار أول صغير - آلة حاسبة، وساعة توقيت، ولعبة مصغّرة، وإعدادات؛ وتوضّح بوابة Wear OS ما تحتويه كل نسخة.

يتوفر أيضًا وجه ساعة منفصل ومجاني لنظام Wear OS 6 وما بعده: FastMediaSorter Watch Face. يعرض وقتًا كبيرًا والتاريخ وموجات وجسيمات عائمة وأشرطة البطارية وما يصل إلى ثمانية أزرار دائرية لاختصارات FastMediaSorter أو بيانات أخرى من الساعة؛ وتظهر الأزرار مع تطبيق FastMediaSorter للساعة. ثبّته من Google Play على الساعة نفسها (ابحث عن FastMediaSorter)، أو افتح صفحته على الساعة من إعدادات Wear في تطبيق الهاتف.

وثائق Wear OS:

• 🌟 بوابة Wear OS على الويب - عرض كامل للميزات، ولقطات شاشة، وتنزيلات من متاجر التطبيقات
• البدء السريع مع Wear OS - دليل خطوة بخطوة للاقتران والإعداد
• إعداد Wear OS - بنية الوحدة وإعداد جسر الرفيق
• قسم Wear OS في الميزات

تعليمات البناء

المتطلبات

• Android Studio Hedgehog (2023.1.1) أو أحدث

• JDK 17+
• Android SDK 35
• أدنى إصدار Android: 8.0 (API 26) لإصدارات Standard/Lite/Photos/VR/noLegal؛ و6.0 (API 23) لإصدار Legacy

البناء

1. استنسخ المستودع:

    git clone https://github.com/SerZhyAle/FastMediaSorter_mob_v2.git
    cd FastMediaSorter_mob_v2
   

2. افتح المشروع في Android Studio.
3. انتظر حتى تكتمل مزامنة Gradle.
4. شغّل التطبيق على محاكي أو جهاز فعلي.

أوامر البناء المفضّلة (Windows / PowerShell)

.\build-debug.PS1
.\gradlew.bat :app_v2:assembleStandardDebug
.\gradlew.bat testStandardDebugUnitTest
.\gradlew.bat :app_v2:lintStandardDebug

ملفات APK المبنية 📦

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

الاختبار 🧪

يستخدم FastMediaSorter v2 أداة Maestro للاختبار الشامل (end-to-end) لضمان جودة التطبيق وموثوقيته.

تشغيل اختبار سريع

# Install Maestro - macOS/Linux (Homebrew)
brew tap mobile-dev-inc/tap
brew install maestro

# Or Linux/macOS (curl)
curl -Ls "https://get.maestro.mobile.dev" | bash

# Windows (PowerShell as Administrator) - External: install.ps1 is the Maestro installer
Invoke-WebRequest -Uri "https://get.maestro.mobile.dev/install.ps1" -OutFile install.ps1
.\install.ps1  # External: Maestro installer
Remove-Item install.ps1  # External: Maestro installer

# Run smoke tests (2-3 minutes)
./maestro/run-tests.sh smoke    # Linux/macOS
.\maestro\run-tests.ps1 smoke   # Windows

# Or use shortcut
.\scripts\utils\run-maestro-smoke.ps1  # Windows

ملاحظة: لا تستخدم npm install -g maestro-cli - فهذه حزمة مختلفة لا علاقة لها بالأمر!

مجموعات الاختبار

• اختبارات الدخان (Smoke Tests) (maestro/smoke/): اختبارات للوظائف الأساسية (~2-3 دقائق)
  • إطلاق التطبيق والأذونات
  • تصفح الملفات المحلية
  • تشغيل الوسائط
  • عرض الصور
• اختبارات المسار الحرج (Critical Path Tests) (maestro/critical/): العمليات الأساسية (~1-2 دقيقة)
  • عمليات الملفات (نسخ، نقل، حذف)
  • ثبات الإعدادات

الوثائق

• 📚 دليل البدء السريع
• 📝 كتابة الاختبارات
• 🔍 أمثلة الاختبارات
• 🔧 استكشاف الأخطاء وإصلاحها
• 📖 الوثائق الكاملة

تكامل CI/CD

تُشغَّل الاختبارات تلقائيًا مع كل push عبر GitHub Actions. راجع .github/workflows/maestro-tests.yml.

الخطوات الأولى (دليل استخدام سريع) 🚀

1. إضافة مجلد (مورد):
   • في الشاشة الرئيسية، اضغط الزر بأيقونة “زائد” (+) لإضافة مورد جديد.
   • اختر نوع المورد (مثلًا “مجلد محلي”).
   • استخدم الفحص أو أضف المجلد يدويًا. بعد الإضافة، سيظهر في القائمة على الشاشة الرئيسية.
2. عرض الملفات:
   • انقر نقرًا مزدوجًا (أو اضغط مطولًا) على المورد المُضاف في القائمة.
   • ستفتح شاشة التصفح، حيث سترى جميع ملفات الوسائط من هذا المجلد كقائمة أو شبكة.
   • استخدم أزرار اللوحة العلوية للفرز أو التصفية أو تبديل طريقة العرض.
3. التشغيل والفرز:
   • اضغط أي ملف لفتحه في المشغّل بملء الشاشة.
   • استخدم التمرير يمينًا/يسارًا أو مناطق اللمس للتنقل بين الملفات.
   • للعمليات (نسخ، نقل)، استخدم مناطق اللمس المقابلة أو الأزرار في لوحة التحكم.
4. إعداد مجلدات الوجهة (Destinations):
   • في الإعدادات، ضمن علامة تبويب “الوجهات”، يمكنك تحديد ما يصل إلى 30 مجلدًا تُستخدم للفرز السريع.
   • أو فعّل “هو وجهة” في شاشة تحرير أي مورد لإضافته إلى قائمة الفرز السريع.
   • بعد ذلك، ستظهر أزرار لنسخ الملفات أو نقلها بسرعة إلى هذه المجلدات في شاشة المشغّل.

حزمة التقنيات

• اللغة: Kotlin
• البنية: Clean Architecture، وMVVM
• الواجهة: نظام Android View (XML)، وMaterial Design 3
• العمليات غير المتزامنة: Kotlin Coroutines وFlow
• حقن التبعيات (DI): Hilt (Dagger)
• قاعدة البيانات: Room 2.7.0
• التنقل: AndroidX Navigation Component
• الوسائط: ExoPlayer (Media3 1.2.1)
• تحميل الصور: Glide 5.0.9 مع NetworkFileModelLoader مخصّص
• بروتوكولات الشبكة:
  • SMB: SMBJ 0.12.1 مع BouncyCastle (تبعية انتقالية)
  • SFTP: JSch 0.2.26 (نسخة com.github.mwiede المتفرعة، مع Ed25519 مدمج)
  • FTP: Apache Commons Net 3.10.0
• السحابة: Google Drive API، وOneDrive (MSAL)، وDropbox API مع OAuth 2.0
• التعرف الضوئي والترجمة:
  • Tesseract4Android (Tesseract 5.3.x) - استخراج النص بالحروف اللاتينية والسيريلية
  • Google ML Kit (ترجمة، وتحديد اللغة) - ترجمة النص المُستخرج
• البحث وكلمات الأغاني: api.lyrics.ovh (JSON API)

إصدار البناء

صيغة الإصدار: Y.YM.MDDH.Hmm (مثال: 2.60.1102.207 لتاريخ 2026/01/10 الساعة 20:07)

راجع dev/CHANGELOG.md لملاحظات الإصدار التفصيلية.

---

المساهمة 🤝

طلبات السحب (Pull Requests) مرحّب بها. للتغييرات الكبيرة، يُرجى فتح تذكرة (issue) أولًا لمناقشة ما تريد تغييره.

التواصل 📧

• المطوّر: sza@ukr.net
• الموقع: https://serzhyale.github.io/FastMediaSorter_mob_v2/
• تذاكر GitHub: https://github.com/SerZhyAle/FastMediaSorter_mob_v2/issues

الترخيص 📄

معلومات قانونية عن المشروع:

• شروط الخدمة
• سياسة الخصوصية
• مكوّنات المصدر المفتوح