FileSlider v1.0

FileSlider, klasörlerden resimlerinizi ve müzik dosyalarınızı otomatik olarak okuyan ve tarayıcıda bir slayt gösterisi sunan çevrimdışı/çevrimiçi bir slayt gösterisi aracıdır. Resimleri birden fazla çözünürlükte (4K ve FullHD dahil) ölçeklendirir ve müzik için küçük resimler ve çalma listeleri oluşturur.

---

İndir:

FileSlider v1.0'ı indir

Kurulum & Kullanım

1. Projeyi indir

Tüm projeyi indir ve istediğin bir klasöre çıkar.
Not: Eğer web için de kullanmak istersen, küçük harflerle ve boşluksuz bir klasör adı önerilir.

2. Resim & Müzik ekle

• Orijinal resimlerini (JPG, PNG) images/ klasörüne yerleştir.
• Müzik dosyalarını (MP3, WAV) music/ klasörüne yerleştir.

3. Slayt gösterisi oluştur

• Windows: start.bat üzerine çift tıkla.
• macOS/Linux: start.sh dosyasını çalıştırılabilir yap (chmod +x start.sh), ardından çift tıkla veya terminalde başlat:

./start.sh

• macOS (FileSlider.app): Eğer mevcutsa, FileSlider.app üzerine çift tıklaman yeterlidir.
  Güvenlik ayarlarında çalıştırmaya bir kereliğine izin vermen gerekebilir.

4. Resim & Müzik işle

• Resimlerin otomatik olarak küçültüldüğü (240px/1920px/3840px) bir terminal açılacaktır.
• Tüm resimlerden public/ içinde bir imageList.js oluşturulur; müzik için ise bir musicList.js.
• Betik tamamlandığında, index.html varsayılan tarayıcıda açılır.
• Slayt gösterisi, index.html dosyasını açarak istediğin zaman manuel olarak da başlatılabilir.

5. Slayt gösterisinin keyfini çıkar

• Slayt gösterisi tüm resimleri tarayıcıda ses olmadan gösterir.
• Sayfaya tıklamak (varsa) müziği başlatır ve aynı anda tam ekran moduna geçer. Güvenlik nedenleriyle, çoğu tarayıcıda müzik çalmak için bir eylem gereklidir.
• Resimler alfabetik olarak sıralanır. Uygun adlarla (örn. "001_, 002_...") sırayı kontrol edebilirsin.

---

Çalışma Şekli

• Çevrimdışı:
  Slayt gösterisi tamamen çevrimdışı çalışır (sunucu gerekmez). Oluşturulan listeler (imageList.js, musicList.js) doğrudan tarayıcı tarafından okunur.
• Çevrimiçi:
  Araç, sayfanın HTTP/HTTPS üzerinden yüklendiğini tespit ederse, yükleme sürelerini azaltmak için otomatik olarak 1920px resimler kullanılır. Bir sonraki resim önbelleğe yüklenir, böylece zayıf bir bağlantıda bile akıcı bir akış sağlanır.
• Resim Galerisi:
  slide_show.html içinde kompakt bir genel bakış galerisi (240px) bulunur. Bir resme tıklayarak slayt gösterisini tam o noktadan başlatırsın. Küçük resimler sayesinde 1000'den fazla resim içeren çok büyük sunumlar bile mümkündür.
• Yeni İçerik:
  Yeni resimler veya müzik eklersen, sadece 3. adımı (başlangıç betiğini çalıştır) tekrarla. Mevcut küçük resimler ve listeler güncellenecektir. Eski resimleri kaldırmak istersen, onları images/ klasöründen sil ve (gerekirse) images-240, images-1920, images-3840 klasörlerini sil. Ardından betiği tekrar başlat.

---

Klasör Yapısı (Örnek)

FileSlider/
├─ start.bat             (Windows Başlangıç Betiği)
├─ start.sh              (macOS/Linux Başlangıç Betiği)
├─ FileSlider.app        (macOS: İsteğe bağlı, kolay başlatma için)
├─ index.html            (Ana Slayt Gösterisi)
├─ slide_show.html       (Genel Bakış Galerisi)
├─ generateImageList.js  (Resim/Müzik Listesi için Node.js Betiği)
├─ nodejs/               (Taşınabilir Node.js, kurulum gerektirmez)
├─ node_modules/         (Sharp gibi bağımlılıkları içerir)
├─ images/               (Orijinal Resimler)
├─ images-240/           (Küçük Resimler 240px)
├─ images-1920/          (Küçük Resimler 1920px)
├─ images-3840/          (Küçük Resimler 3840px)
├─ music/                (Müzik Dosyaları)
└─ public/
   ├─ imageList.js       (Tüm Resimlerin Listesi)
   └─ musicList.js       (Tüm Müzik Dosyalarının Listesi)

---

Notlar & İpuçları

• Dosya Adlarından Metinler:
  Slayt gösterisi, dosya adını (uzantısız) otomatik olarak başlık/açıklama olarak gösterir.
• Birden Fazla Çözünürlük:
  Farklı cihazlar için otomatik olarak 240px/1920px/3840px sürümleri oluşturulur.
• Terminal Penceresi:
  Sisteme bağlı olarak, günlük çıktılarını göstermek için terminal açık kalır. Kapatmak için herhangi bir tuşa bas veya exit yaz.
• Zaman, CSS ve Fonksiyondaki Değişiklikler:
  Tüm gösteri index.html dosyasında değiştirilebilir. Orada CSS'i ve ayrıca resim başına bekleme sürelerini bulabilirsin. slide_show.html dosyasında genel bakış sayfasının tüm girişlerini bulabilirsin. Burada, örneğin ziyaretçilere bir ipucu veya bağlantı iletmek için kendi bağlantılarını, resimlerini vb. ekleyebilirsin.

---

Bilinen Sorunlar

• Dosyalar bulunamıyor:
  Büyük/küçük harf duyarlılığına dikkat et (özellikle Linux altında).
• macOS Güvenlik Ayarları:
  FileSlider.app veya start.sh ilk kez çalıştırıldığında bir güvenlik uyarısı görüntülenebilir. Orada "Sistem Ayarları → Güvenlik & Gizlilik" bölümünde manuel olarak çalıştırmaya izin ver.
• Cep telefonları tam ekran moduna yalnızca isteksizce geçer, bu nedenle araç esas olarak ekranlarda ve projektörlerde fotoğraf gösterileri için kullanılır.
• og:image ve og:url teknik olarak saf bir HTML dosyasında mümkün değildir, ancak projeye göre isteğe bağlı olarak eklenebilir. Entegrasyon, PHP'ye geçişi gerektirir ve bu da önemli dezavantajlara yol açar, çünkü o zaman sadece bir web sunucusuyla çalışabilirdi.

---

Lisans & Teşekkürler

• FileSlider Yazılımı & Betikleri: © Johann Dirschl / DIRSCHL.com GmbH, 2025.
• Demodaki Resimler: DIRSCHL.com GmbH'ye aittir ve lisanslanabilir.
• nuonu.com Üzerinden Müzik:
  Lisanssız müziğe ihtiyacı olanlar, bunu sayfamızda ve nuonu.com adresinde bulabilirler. Orada
  yapay zeka yardımıyla oluşturulmuş birçok kısa ve enstrümantal parça bulunmaktadır. Ancak her müzik dosyası çalışır. Web'de dosyaları küçük tutmalısın (MP3). Çevrimdışı olarak WAV dosyalarını da kullanabilirsin.
• Maliyetler:
  Müşterilerimiz için kullanım ücretsizdir. Diğerleri müzik, eklentiler ve uygulamaları ücretsiz olarak indirebilir ve test edebilir. Eğer bunları ticari olarak kullanmak istersen, nuonu.com → Connect adresinden 49 EUR karşılığında bir yıllık lisans (süresiz) satın alabilirsin. İhtiyaç halinde ürünleri memnuniyetle genişletiriz.
• Node.js: © Joyent Inc. / OpenJS Foundation (Taşınabilir Node.js dahildir).
• Bağımlılıklar: (örn. Sharp) kendi açık kaynak lisansları altında.

FileSlider ile iyi eğlenceler!