Guida tecnica – leNostre50

Slideshow avanzato con audio, sottocartelle e sfondi personalizzati

**Autore**: Umberto Vittani

**Assistenza**: AI Linda

**Ultima versione**: luglio 2025

1. MP3 e Slideshow

La pagina `slideShow.php` esegue automaticamente i file `.mp3` presenti nella **stessa cartella** delle foto o nelle **sottocartelle** (se specificate).
I file audio devono:
avere estensione `.mp3`,
**non** contenere caratteri speciali o spazi nel nome,
essere leggibili dal browser (preferibilmente codifica standard).
Se è presente **almeno un file MP3**, appare il pulsante 🎵 `Start Audio`.
I brani vengono riprodotti **in sequenza**, **senza limite di numero**.

2. Slideshow con sottocartelle

Lo slideshow **multi-cartella** viene attivato dalla presenza del file `slide.txt` nella cartella principale.
Il file `slide.txt` elenca le sottocartelle da includere, **una per riga**, nell’**ordine desiderato**. Esempio:


      slide.txt
      01-milano
      02-como
      03-valtellina

Ogni sottocartella può contenere immagini e, opzionalmente, uno o più file audio `.mp3`.
Le immagini vengono concatenate in un unico slideshow ordinato (per nome o ordine nel file).
Tutti i file `.mp3` presenti nelle sottocartelle vengono inclusi nella playlist audio finale.

---

🛠️ Script automatico `genera_slide_safe.sh`

Per generare automaticamente i file `slide.txt` in tutte le cartelle che contengono sottocartelle utili:

Usa lo script:

```

/home/vitti/script/genera_slide_safe.sh

```

Lo script **non sovrascrive** i file `slide.txt` già esistenti, ed esclude cartelle come `FotoDaArchiviare/`, `test/`, `999`, `thumbs`, ecc.

---

🔄 Modificare l’ordine dello slideshow

Se desideri cambiare l’ordine delle sottocartelle:

1. **Rinomina** le sottocartelle nell’ordine desiderato (es. con prefissi numerici):

```

01-PrimaTappa

02-SecondaTappa

...

10-LocalitàFinale

```

2. **Elimina** l’eventuale file `slide.txt` già presente nella cartella principale.

3. **Rigenera** il file `slide.txt` rilanciando lo script tramite `cron`:

```bash

sudo run-parts --report /etc/cron.monthly

```

oppure esegui direttamente lo script:

```bash

/home/vitti/script/genera_slide_safe.sh

```

3. Wallpaper e sfondi casuali

Se esiste almeno un file immagine in `/web_wallpaper/2023/` (per l’anno corrente), lo script può usarlo come **sfondo casuale**.
Le immagini con `-wp` nel nome, anche se in altre cartelle, vengono considerate **wallpaper personalizzati** e possono essere usate come sfondo.

4. Percorsi e ambienti

Su **NAS Synology**: le path assolute iniziano con `/volume1/web/`
Su **Manjaro / ProDesk G3**: i percorsi sono in `/srv/http/`
Il codice rileva automaticamente l’ambiente, ma alcune configurazioni potrebbero richiedere **adattamenti manuali** nei path (es. cartelle audio o sfondi).

5. Suggerimenti e buone pratiche

✅ Usa nomi file semplici: **niente spazi, accenti o simboli strani**

✅ Verifica che ci sia almeno un MP3 se vuoi che appaia il bottone audio

✅ In caso di problemi audio, controlla **formato MP3 e supporto browser**

6. Toolbar slideshow – guida ai pulsanti

La toolbar appare sul lato destro e **scompare automaticamente** dopo 3 secondi di inattività (mouse). Ecco il significato dei pulsanti principali:

| Pulsante | Descrizione |

|---------------|--------------------------------------|

| ▶ `Start` | Avvia la presentazione |

| ⏸ `Pausa` | Ferma la slideshow |

| 🔁 `Restart` | Riavvia la slideshow dall'inizio |

| ⛶ `FullScreen` | Attiva/disattiva schermo intero |

| 🐇 `Speed+` | Aumenta la velocità di cambio foto |

| 🐢 `Reset` | Ripristina la velocità a 5s |

| 🔍 `Zoom` | Ingrandisce l’immagine principale |

| 🔄 `Zoom Reset` | Torna allo zoom originale (1:1) |

| 🔊 `Start Audio` | Avvia la playlist musicale |

| ⏸ `Pause Audio` | Ferma la musica |

| ⏭ `Next Audio` | Salta al brano successivo |

| ❌ `Chiudi` | Chiude la finestra/slideshow |

In alto compare un **contatore delle foto** e uno **slider** per saltare rapidamente a una foto specifica.

7. Novità in leNostre50

Ordinamento **case-insensitive** dei file immagine (`JPG` = `jpg`)
Gestione migliorata delle sottocartelle e dei wallpaper
Interfaccia più fluida e compatibile anche su browser lenti
Documentazione online e integrata (visualizzazione diretta dei `.md`)

> *Per feedback o problemi tecnici, rivolgersi a Vitti, con amore dal G3 di casaRosini 💻🐾*