FileSlider v1.0

FileSlider è uno strumento di slideshow offline/online che legge automaticamente le tue immagini e file musicali dalle cartelle e fornisce una presentazione nel browser. Scala le immagini in diverse risoluzioni (tra cui 4K e FullHD) e genera miniature e playlist per la musica.

---

Download:

Scarica FileSlider v1.0

Installazione & Utilizzo

1. Scarica il progetto

Scarica l'intero progetto e decomprimilo in una cartella qualsiasi.
Nota: Se desideri utilizzarlo anche per il web, si consiglia un nome di cartella in minuscolo e senza spazi.

2. Aggiungi immagini & musica

• Metti le tue immagini originali (JPG, PNG) nella cartella images/.
• Metti i tuoi file musicali (MP3, WAV) nella cartella music/.

3. Crea la slideshow

• Windows: Fai doppio clic su start.bat.
• macOS/Linux: Rendi start.sh eseguibile (chmod +x start.sh), quindi fai doppio clic o avvia dal terminale:

./start.sh

• macOS (FileSlider.app): Se presente, è sufficiente un doppio clic su
  FileSlider.app. Potrebbe essere necessario consentire l'esecuzione una tantum nelle impostazioni di sicurezza.

4. Elabora immagini & musica

• Si aprirà un terminale in cui le immagini verranno automaticamente ridimensionate (240px/1920px/3840px).
• Da tutte le immagini verrà inoltre generato un file imageList.js in public/; per la musica, un file musicList.js.
• Una volta completato lo script, index.html si aprirà nel browser predefinito.
• La slideshow può essere avviata manualmente in qualsiasi momento aprendo index.html.

5. Goditi la slideshow

• La presentazione mostra tutte le immagini nel browser senza audio.
• Un clic sulla pagina avvia la musica (se presente) e passa contemporaneamente alla modalità a schermo intero. Per motivi di sicurezza, la maggior parte dei browser richiede un'azione per riprodurre la musica.
• Le immagini sono ordinate alfabeticamente. Puoi controllare l'ordine con nomi appropriati (ad esempio, „001_, 002_...“).

---

Funzionamento

• Offline:
  La slideshow funziona completamente offline (nessun server necessario). Gli elenchi generati (imageList.js, musicList.js) vengono letti direttamente dal browser.
• Online:
  Se lo strumento rileva che la pagina viene caricata tramite HTTP/HTTPS, vengono utilizzate automaticamente le immagini da 1920px per ridurre i tempi di caricamento. L'immagine successiva viene caricata nella cache, garantendo un flusso fluido anche con una connessione debole.
• Galleria di immagini:
  In slide_show.html è presente una galleria di panoramica compatta (240px). Cliccando su un'immagine, avvii la slideshow esattamente da quel punto. Grazie alle immagini piccole, sono possibili anche presentazioni molto grandi con più di 1000 immagini.
• Nuovi contenuti:
  Se aggiungi nuove immagini o musica, ripeti semplicemente il passaggio 3 (esegui lo script di avvio). Le miniature e gli elenchi esistenti verranno aggiornati. Se desideri rimuovere vecchie immagini, eliminale da images/ ed elimina le cartelle images-240, images-1920, images-3840 (se necessario). Quindi riavvia lo script.

---

Struttura delle cartelle (Esempio)

FileSlider/
├─ start.bat             (Script di avvio Windows)
├─ start.sh              (Script di avvio macOS/Linux)
├─ FileSlider.app        (macOS: Opzionale, per un avvio semplice)
├─ index.html            (Slideshow principale)
├─ slide_show.html       (Galleria di panoramica)
├─ generateImageList.js  (Script Node.js per l'elenco di immagini/musica)
├─ nodejs/               (Node.js portatile, per non richiedere installazione)
├─ node_modules/         (Contiene dipendenze come 'sharp')
├─ images/               (Immagini originali)
├─ images-240/           (Miniature 240px)
├─ images-1920/          (Miniature 1920px)
├─ images-3840/          (Miniature 3840px)
├─ music/                (File musicali)
└─ public/
   ├─ imageList.js       (Elenco di tutte le immagini)
   └─ musicList.js       (Elenco di tutti i file musicali)

---

Note & Consigli

• Testi dai nomi dei file:
  La slideshow mostra automaticamente il nome del file (senza estensione) come titolo/didascalia.
• Risoluzioni multiple:
  Vengono create automaticamente versioni da 240px/1920px/3840px per diversi dispositivi.
• Finestra del terminale:
  A seconda del sistema, il terminale rimane aperto per mostrare gli output di log. Premi un tasto qualsiasi o digita exit per chiuderlo.
• Modifiche a tempo, CSS e funzione:
  L'intera presentazione può essere modificata in index.html. Lì troverai il CSS, ma anche i tempi di visualizzazione per immagine. In slide_show.html troverai tutte le voci della pagina di panoramica. Qui potresti aggiungere i tuoi link, immagini, ecc., per comunicare, ad esempio, un suggerimento o un link ai visitatori.

---

Problemi noti

• File non trovati:
  Presta attenzione alla distinzione tra maiuscole e minuscole (specialmente su Linux).
• Impostazioni di sicurezza macOS:
  Alla prima esecuzione di FileSlider.app o start.sh, potrebbe apparire un avviso di sicurezza. Consenti manualmente l'esecuzione in „Impostazioni di Sistema → Sicurezza & Privacy“.
• I telefoni cellulari entrano in modalità a schermo intero solo con riluttanza, motivo per cui lo strumento è utilizzato principalmente per presentazioni fotografiche su schermi e proiettori.
• og:image e og:url non sono tecnicamente possibili in un file HTML puro, ma possono essere aggiunti per ogni progetto. L'integrazione richiederebbe il passaggio a PHP e ciò comporterebbe notevoli svantaggi, poiché funzionerebbe solo con un server web.

---

Licenza & Crediti

• Software & Script FileSlider: © Johann Dirschl / DIRSCHL.com GmbH, 2025.
• Immagini nella demo: Sono proprietà di DIRSCHL.com GmbH e possono essere concesse in licenza.
• Musica tramite nuonu.com:
  Chi ha bisogno di musica senza licenza la trova anche sul nostro sito e su nuonu.com. Lì ci sono
  molti brani brevi e anche strumentali creati con l'aiuto dell'IA. Tuttavia, funziona qualsiasi file musicale. Sul web dovresti mantenere i file piccoli (MP3). Offline puoi anche usare file WAV.
• Costi:
  Per i nostri clienti l'utilizzo è gratuito. Altri possono scaricare e testare gratuitamente musica, plugin e app. Se desideri utilizzarli commercialmente, puoi acquistare una licenza annuale (senza scadenza) per 49 EUR su nuonu.com → Connect . Siamo lieti di espandere i prodotti se necessario.
• Node.js: © Joyent Inc. / OpenJS Foundation (Il Node.js portatile è incluso).
• Dipendenze: (ad es. Sharp) sotto le rispettive licenze open source.

Divertiti con FileSlider!