FileSlider v1.0

FileSlider to narzędzie do pokazów slajdów offline/online, które automatycznie wczytuje Twoje obrazy i pliki muzyczne z folderów i prezentuje pokaz slajdów w przeglądarce. Skaluje obrazy w wielu rozdzielczościach (m.in. 4K i FullHD) oraz generuje miniatury i playlisty dla muzyki.

---

Pobierz:

Pobierz FileSlider v1.0

Instalacja i użytkowanie

1. Pobierz projekt

Pobierz cały projekt i rozpakuj go do dowolnego folderu.
Wskazówka: Jeśli chcesz używać go również w sieci, zaleca się nazwę folderu małymi literami i bez spacji.

2. Dodaj obrazy i muzykę

• Umieść swoje oryginalne obrazy (JPG, PNG) w folderze images/.
• Umieść swoje pliki muzyczne (MP3, WAV) w folderze music/.

3. Utwórz pokaz slajdów

• Windows: Kliknij dwukrotnie start.bat.
• macOS/Linux: Uczyń start.sh wykonywalnym (chmod +x start.sh), a następnie kliknij dwukrotnie lub uruchom w terminalu:

./start.sh

• macOS (FileSlider.app): Jeśli jest dostępny, wystarczy dwukrotnie kliknąć
  FileSlider.app. Może być konieczne jednorazowe zezwolenie na uruchomienie w ustawieniach bezpieczeństwa.

4. Przetwarzanie obrazów i muzyki

• Otworzy się terminal, w którym obrazy zostaną automatycznie zmniejszone (240px/1920px/3840px).
• Ze wszystkich obrazów zostanie również wygenerowany plik imageList.js w public/; dla muzyki plik musicList.js.
• Po zakończeniu skryptu, plik index.html otworzy się w domyślnej przeglądarce.
• Pokaz slajdów można również uruchomić ręcznie w dowolnym momencie, otwierając plik index.html.

5. Ciesz się pokazem slajdów

• Pokaz slajdów wyświetla wszystkie obrazy w przeglądarce bez dźwięku.
• Kliknięcie na stronę uruchamia muzykę (jeśli jest dostępna) i jednocześnie przełącza na tryb pełnoekranowy. Ze względów bezpieczeństwa większość przeglądarek wymaga akcji, aby odtworzyć muzykę.
• Obrazy są sortowane alfabetycznie. Za pomocą odpowiednich nazw (np. „001_, 002_...”) możesz kontrolować kolejność.

---

Jak to działa

• Offline:
  Pokaz slajdów działa całkowicie offline (nie jest potrzebny serwer). Wygenerowane listy (imageList.js, musicList.js) są wczytywane bezpośrednio przez przeglądarkę.
• Online:
  Jeśli narzędzie wykryje, że strona jest ładowana przez HTTP/HTTPS, automatycznie używane są obrazy 1920px, aby skrócić czas ładowania. Kolejny obraz jest ładowany do pamięci podręcznej, co zapewnia płynne działanie nawet przy słabym połączeniu.
• Galeria obrazów:
  W pliku slide_show.html znajduje się kompaktowa galeria przeglądowa (240px). Kliknięcie na obraz uruchamia pokaz slajdów dokładnie w tym miejscu. Dzięki małym obrazom możliwe są również bardzo duże prezentacje z ponad 1000 zdjęć.
• Nowa zawartość:
  Jeśli dodasz nowe obrazy lub muzykę, po prostu powtórz krok 3 (uruchom skrypt startowy). Istniejące miniatury i listy zostaną zaktualizowane. Jeśli chcesz usunąć stare obrazy, usuń je z images/ i usuń foldery images-240, images-1920, images-3840 (w razie potrzeby). Następnie uruchom skrypt ponownie.

---

Struktura folderów (przykład)

FileSlider/
├─ start.bat             (Skrypt startowy Windows)
├─ start.sh              (Skrypt startowy macOS/Linux)
├─ FileSlider.app        (macOS: Opcjonalnie, do łatwego uruchamiania)
├─ index.html            (Główny pokaz slajdów)
├─ slide_show.html       (Galeria przeglądowa)
├─ generateImageList.js  (Skrypt Node.js do listy obrazów/muzyki)
├─ nodejs/               (Przenośny Node.js, aby instalacja nie była konieczna)
├─ node_modules/         (Zawiera zależności takie jak 'sharp')
├─ images/               (Oryginalne obrazy)
├─ images-240/           (Miniatury 240px)
├─ images-1920/          (Miniatury 1920px)
├─ images-3840/          (Miniatury 3840px)
├─ music/                (Pliki muzyczne)
└─ public/
   ├─ imageList.js       (Lista wszystkich obrazów)
   └─ musicList.js       (Lista wszystkich plików muzycznych)

---

Wskazówki i porady

• Teksty z nazw plików:
  Pokaz slajdów automatycznie wyświetla nazwę pliku (bez rozszerzenia) jako tytuł/podpis.
• Wiele rozdzielczości:
  Dla różnych urządzeń automatycznie tworzone są wersje 240px/1920px/3840px.
• Okno terminala:
  W zależności od systemu, terminal pozostaje otwarty, aby wyświetlać komunikaty logów. Naciśnij dowolny klawisz lub wpisz exit, aby go zamknąć.
• Zmiany w czasie, CSS i funkcji:
  Cały pokaz można zmienić w pliku index.html. Znajdziesz tam CSS, ale także czasy wyświetlania dla każdego obrazu. W pliku slide_show.html znajdziesz wszystkie wpisy strony przeglądowej. Tutaj możesz dodać własne linki, obrazy itp., aby np. przekazać odwiedzającym wskazówkę lub link.

---

Znane problemy

• Pliki nie zostały znalezione:
  Zwróć uwagę na wielkość liter (zwłaszcza w systemie Linux).
• Ustawienia bezpieczeństwa macOS:
  Przy pierwszym uruchomieniu FileSlider.app lub start.sh może pojawić się ostrzeżenie o bezpieczeństwie. Zezwól ręcznie na uruchomienie w „Ustawieniach systemowych → Bezpieczeństwo i prywatność”.
• Telefony komórkowe niechętnie przechodzą w tryb pełnoekranowy, dlatego narzędzie jest używane głównie do pokazów zdjęć na ekranach i projektorach.
• og:image i og:url nie są technicznie możliwe w czystym pliku HTML, ale mogą być. w razie potrzeby aktualizowane dla każdego projektu. Włączenie wymagałoby przejścia na PHP, co miałoby znaczne wady, ponieważ działałoby wtedy tylko z serwerem WWW.

---

Licencja i podziękowania

• Oprogramowanie i skrypty FileSlider: © Johann Dirschl / DIRSCHL.com GmbH, 2025.
• Obrazy w demo: Są własnością DIRSCHL.com GmbH i mogą być licencjonowane.
• Muzyka przez nuonu.com:
  Kto potrzebuje muzyki bez licencji, znajdzie ją również na naszej stronie i nuonu.com. Tam znajdziesz
  wiele krótkich utworów i utworów instrumentalnych, które zostały stworzone za pomocą AI. Działa jednak każdy plik muzyczny. W sieci powinieneś utrzymywać małe pliki (MP3). Offline możesz również używać plików WAV.
• Koszty:
  Dla naszych klientów korzystanie jest bezpłatne. Inni mogą bezpłatnie pobierać i testować muzykę, wtyczki i aplikacje. Jeśli chcesz używać ich komercyjnie, możesz nabyć roczną licencję (bez wygaśnięcia) za 49 EUR na stronie nuonu.com → Connect . Chętnie rozszerzymy produkty w razie potrzeby.
• Node.js: © Joyent Inc. / OpenJS Foundation (Przenośny Node.js jest dołączony).
• Zależności: (np. Sharp) na podstawie ich odpowiednich licencji open-source.

Baw się dobrze z FileSlider!