FileSlider v1.0

FileSlider هي أداة عرض شرائح تعمل بلا إنترنت وعبر الإنترنت، تقوم تلقائيًا بقراءة صورك وملفات الموسيقى من المجلدات وتوفير عرض شرائح في المتصفح. تقوم بتغيير حجم الصور بدقة متعددة (بما في ذلك 4K و FullHD) وتنشئ صورًا مصغرة وقوائم تشغيل للموسيقى.

---

تنزيل:

تنزيل FileSlider v1.0

التثبيت والاستخدام

1. تنزيل المشروع

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

2. إضافة الصور والموسيقى

• ضع صورك الأصلية (JPG, PNG) في المجلد images/.
• ضع ملفات الموسيقى الخاصة بك (MP3, WAV) في المجلد music/.

3. إنشاء عرض الشرائح

• Windows: انقر نقرًا مزدوجًا على start.bat.
• macOS/Linux: اجعل start.sh قابلاً للتنفيذ (chmod +x start.sh)، ثم انقر نقرًا مزدوجًا أو ابدأ من الطرفية:

./start.sh

• macOS (FileSlider.app): إذا كان متاحًا، يكفي النقر المزدوج على
  FileSlider.app. قد تحتاج إلى السماح بالتنفيذ مرة واحدة في إعدادات الأمان.

4. معالجة الصور والموسيقى

• ستفتح نافذة طرفية حيث يتم تصغير الصور تلقائيًا (240px/1920px/3840px).
• سيتم أيضًا إنشاء ملف imageList.js في public/ من جميع الصور؛ وملف musicList.js للموسيقى.
• بمجرد انتهاء السكريبت، سيتم فتح index.html في المتصفح الافتراضي.
• يمكن بدء عرض الشرائح يدويًا في أي وقت عن طريق فتح index.html.

5. استمتع بعرض الشرائح

• يعرض عرض الشرائح جميع الصور في المتصفح بدون صوت.
• يؤدي النقر على الصفحة إلى بدء تشغيل الموسيقى (إذا كانت موجودة) والتبديل إلى وضع ملء الشاشة في نفس الوقت. لأسباب أمنية، تتطلب معظم المتصفحات إجراءً لتشغيل الموسيقى.
• يتم فرز الصور أبجديًا. باستخدام أسماء مناسبة (مثل "001_, 002_...")، يمكنك التحكم في الترتيب.

---

كيف يعمل

• بلا إنترنت:
  يعمل عرض الشرائح بالكامل بلا إنترنت (لا يلزم وجود خادم). يتم قراءة القوائم التي تم إنشاؤها (imageList.js, musicList.js) مباشرة بواسطة المتصفح.
• عبر الإنترنت:
  إذا اكتشفت الأداة أن الصفحة يتم تحميلها عبر HTTP/HTTPS، فسيتم استخدام صور 1920 بكسل تلقائيًا لتقليل أوقات التحميل. يتم تحميل الصورة التالية في ذاكرة التخزين المؤقت، مما يضمن تشغيلًا سلسًا حتى مع اتصال ضعيف.
• معرض الصور:
  في slide_show.html، يوجد معرض نظرة عامة مدمج (240 بكسل). بالنقر على صورة، تبدأ عرض الشرائح من هذه النقطة بالضبط. بفضل الصور الصغيرة، يمكن تقديم عروض تقديمية كبيرة جدًا تحتوي على أكثر من 1000 صورة.
• محتوى جديد:
  إذا أضفت صورًا أو موسيقى جديدة، فما عليك سوى تكرار الخطوة 3 (تشغيل سكريبت البدء). سيتم تحديث الصور المصغرة والقوائم الموجودة. إذا كنت ترغب في إزالة الصور القديمة، فاحذفها من images/ واحذف المجلدات images-240, images-1920, images-3840 (إذا لزم الأمر). ثم أعد تشغيل السكريبت.

---

هيكل المجلدات (مثال)

FileSlider/\n├─ start.bat             (سكريبت بدء Windows)\n├─ start.sh              (سكريبت بدء macOS/Linux)\n├─ FileSlider.app        (macOS: اختياري، للبدء السهل)\n├─ index.html            (عرض الشرائح الرئيسي)\n├─ slide_show.html       (معرض النظرة العامة)\n├─ generateImageList.js  (سكريبت Node.js لقائمة الصور/الموسيقى)\n├─ nodejs/               (Node.js محمول، لذلك لا يلزم التثبيت)\n├─ node_modules/         (يحتوي على تبعيات مثل 'sharp')\n├─ images/               (الصور الأصلية)\n├─ images-240/           (صور مصغرة 240 بكسل)\n├─ images-1920/          (صور مصغرة 1920 بكسل)\n├─ images-3840/          (صور مصغرة 3840 بكسل)\n├─ music/                (ملفات الموسيقى)\n└─ public/\n   ├─ imageList.js       (قائمة جميع الصور)\n   └─ musicList.js       (قائمة جميع ملفات الموسيقى)\n

---

ملاحظات ونصائح

• نصوص من أسماء الملفات:
  يعرض عرض الشرائح تلقائيًا اسم الملف (بدون امتداد) كعنوان/تسمية توضيحية.
• دقة متعددة:
  يتم إنشاء إصدارات 240 بكسل/1920 بكسل/3840 بكسل تلقائيًا للأجهزة المختلفة.
• نافذة الطرفية:
  اعتمادًا على النظام، تظل الطرفية مفتوحة لعرض مخرجات السجل. اضغط على أي مفتاح أو اكتب exit لإغلاقها.
• تغييرات في الوقت و CSS والوظيفة:
  يمكن تغيير العرض بالكامل في index.html. ستجد هناك CSS، وكذلك أوقات التوقف لكل صورة. في slide_show.html ستجد جميع إدخالات صفحة النظرة العامة. هنا يمكنك إضافة روابطك وصورك الخاصة وما إلى ذلك، على سبيل المثال لإبلاغ الزوار بملاحظة أو رابط.

---

مشاكل معروفة

• لم يتم العثور على الملفات:
  انتبه إلى حالة الأحرف (خاصة في Linux).
• إعدادات أمان macOS:
  عند تشغيل FileSlider.app أو start.sh لأول مرة، قد يتم عرض تحذير أمان. اسمح بالتنفيذ يدويًا في "إعدادات النظام ← الأمان والخصوصية".
• الهواتف المحمولة تدخل وضع ملء الشاشة بتردد، ولهذا السبب تستخدم الأداة بشكل أساسي لعروض الصور على الشاشات وأجهزة العرض.
• og:image و og:url غير ممكنين تقنيًا في ملف HTML خالص، ولكن يمكن تحديثهما لكل مشروع. سيتطلب التضمين التحويل إلى PHP وهذا سيكون له عيوب كبيرة، حيث لن يعمل إلا مع خادم ويب.

---

الترخيص والاعتمادات

• برنامج وسكريبتات FileSlider: © يوهان ديرشل / DIRSCHL.com GmbH, 2025.
• الصور في العرض التوضيحي: هي ملك لشركة DIRSCHL.com GmbH ويمكن ترخيصها.
• الموسيقى عبر nuonu.com:
  من يحتاج إلى موسيقى خالية من حقوق الملكية، سيجدها أيضًا على موقعنا و nuonu.com. هناك
  العديد من المقاطع القصيرة والمقطوعات الموسيقية التي تم إنشاؤها بمساعدة الذكاء الاصطناعي. ولكن أي ملف موسيقى سيعمل. على الويب، يجب أن تحافظ على حجم الملفات صغيرًا (MP3). بلا إنترنت، يمكنك أيضًا استخدام ملفات WAV.
• التكاليف:
  الاستخدام مجاني لعملائنا. يمكن للآخرين تنزيل واختبار الموسيقى والمكونات الإضافية والتطبيقات مجانًا. إذا كنت ترغب في استخدامها تجاريًا، يمكنك شراء ترخيص سنوي (بدون انتهاء صلاحية) مقابل 49 يورو على nuonu.com ← Connect . يسعدنا توسيع المنتجات حسب الحاجة.
• Node.js: © Joyent Inc. / OpenJS Foundation (يتم توفير Node.js المحمول).
• التبعيات: (مثل Sharp) بموجب تراخيصها مفتوحة المصدر.

استمتع بـ FileSlider!