Gare Maty

1. Come si apre l'app

Doppio clic su index.html, oppure sul launcher Avvia.command (Mac) / Avvia.bat (Windows). Per il salvataggio automatico e il riconoscimento dei nuovi video usa Chrome o Edge (su Windows Edge è già il browser predefinito). Funziona su Windows e Mac.

2. La schermata principale

In alto: ricerca e i pulsanti ⛃ Filtri (mostra/nasconde i filtri), ＋ Nuovo, ❓ Aiuto. A destra ⚙ Configura apre un menu con 🔗 Collega cartella e ⤓ Backup dati, e mostra lo stato del salvataggio (un pallino sul pulsante: verde = salvato). Al centro la griglia.

Sui riquadri: in alto a sinistra l'altezza, in alto a destra 🏁 Risultati (se c'è il link), in basso a sinistra 🎬 N extra (se la gara ha clip collegate).

Sotto il titolo compaiono la data e le note (se presenti). I tag servono solo per la ricerca e non vengono mostrati. I video verticali sono mostrati interi; con 📷 puoi ritagliare l'area da mostrare.

3. Cercare e filtrare

Ricerca incrociata: scrivi più parole, vengono cercate ovunque. Es. Arezzo 115 trova i video di Arezzo a 115 cm.

Filtri: di norma sono nascosti. Premi il pulsante ⛃ Filtri (accanto alla ricerca) per farli scendere. Clicca un menu e spunta le voci: più voci nello stesso menu = "oppure", voci in menu diversi = "e". Sul pulsante un numero indica quanti filtri sono attivi. I filtri attivi appaiono come pillole rimovibili (✕). In fondo ai filtri c'è ↺ Azzera filtri, attivo solo quando almeno un filtro è selezionato.

In fondo a ogni menu c'è anche una voce (nessun…) — es. "(nessun cavallo)" — per trovare al volo i video senza quel dato e completarli.

4. Guardare un video

Clic su un riquadro → riproduttore a tutto schermo. Si chiude con ✕, Esc o clic fuori dal video.

Strumenti di modifica: nel player, in basso a destra, c'è una piccola matita ✎. Premila per mostrare 📷 Imposta copertina e ✎ Modifica metadati (di norma nascosti).

Scegliere la miniatura: porta il video sul fotogramma che ti piace, apri gli strumenti (matita) e premi 📷 Imposta copertina, poi trascina e ridimensiona il riquadro 16:9 sull'area da mostrare e premi ✓ Usa come copertina. Con le clip extra, la copertina si imposta sulla versione attiva (la mini-anteprima selezionata).

5. Le clip extra

Una gara può avere più filmati collegati (rallentatore, premiazione, ripresa cellulare…). Le clip extra non stanno in griglia: nel player della gara compare la striscia “Versioni” con una mini-anteprima per il video principale e una per ogni clip. Clicca una mini-anteprima per vedere quella versione; quella attiva è evidenziata in oro.

6. Aprire i risultati / classifica

Se la gara ha la classifica, nel player c'è 🏁 Risultati & classifica: si apre dentro l'app. Alcuni siti (es. FEI) non si lasciano incorporare e si aprono in una scheda del browser: è normale, il link è corretto. Se una pagina resta vuota, usa ↗ Apri in una scheda.

7. Aggiungere nuovi video

1. Copia i file video nella cartella video/.
2. Premi ＋ Nuovo (succede anche da solo all'apertura): l'app controlla la cartella e mostra l'elenco dei file non ancora in dashboard, con i dati già dedotti dal nome.
3. Togli la spunta a quelli da escludere e premi ✓ Aggiungi selezionati.

L'elenco automatico mostra solo i file già dentro video/: un file che sta altrove (es. in Download) lì non comparirà. Per quelli usa uno di questi nel pannello:

• Trascina i file dal Finder/Esplora dentro il pannello: l'app li copia in video/.
• 📁 Carica da file… per sceglierli col selettore del sistema.
• ＋ Scheda vuota per una scheda compilata a mano.

In tutti i casi l'app copia il video in video/ e, se è uno solo, apre l'editor per i metadati.

8. Modificare i dati di un video

Apri un video → ✎ Modifica metadati. I campi Atleta, Località, Cavallo, Tipo gara, Altezza, Periodo, Data ed Etichetta sono a discesa: scrivi un valore nuovo oppure scegline uno già usato dall'elenco.

Campi principali:

Campo	A cosa serve
File	Percorso del video (video/...).
Atleta	A chi appartiene il video — usa il nome completo (es. Matilde Manni) per distinguere gli omonimi. È un filtro (Atleta), ma resta nascosto finché c'è un solo atleta in collezione; compare da solo quando ne aggiungi un secondo.
Titolo / Località / Cavallo / Tipo gara / Altezza / Periodo	Dati mostrati e usati dai filtri (Località, Cavallo, Tipo gara, Altezza, Anno).
Data (AAAA-MM)	Ordina i video e alimenta il filtro Anno, es. 2026-04.
Tag (parole chiave)	Etichette libere per la ricerca. Non collegano nulla.
Clip extra di…	Vuoto = video in griglia. Con l'id di una gara = diventa clip di quella gara (esce dalla griglia).
Etichetta pulsante clip	Nome del pulsante quando è una clip (es. "Slow Motion").
Link risultati	Indirizzo della classifica (mostra il pulsante 🏁).
Note	Testo libero: cercabile dalla barra di ricerca ma non mostrato come tag/pulsante. Appare nel riproduttore.

9. Salvare le modifiche

Premi 🔗 Collega cartella e scegli CollezioneVideo (quella con index.html, non la sottocartella video). Da lì ogni modifica si salva da sola nel file. Indicatore: ● Salvato su file = ok; ● Salvataggio… = in corso; ● Collega la cartella… = non collegato. Su Safari usa ⤓ Backup dati e sostituisci dati-video.js.

10. Utenti e accessi

Da ⚙ Configura → 👥 Utenti definisci chi guarderà i video e quali atleti vede (serve per la futura app sul telefono). Con ＋ Nuovo utente imposti:

• Nome e Ruolo: Admin (vede tutto e gestisce) · Allenatore (vede tutti gli atleti) · Atleta (vede solo gli atleti che spunti).
• Codice di accesso: codice casuale (🔄 rigenera, 📋 copia) con cui l'utente aprirà la sua vista (link …?u=codice), vedendo solo i video che gli spettano.

Come funziona la vista limitata: aprendo l'app con un codice di Atleta o Allenatore, spariscono i comandi di gestione (＋ Nuovo, ⚙ Configura con Utenti, strumenti di modifica) — è una vista di sola lettura; l'Atleta vede solo i suoi atleti. In alto compare 👁 Nome · esci per tornare alla vista completa. Dalla lista utenti, 👁 apre l'anteprima di quella vista.

Richiedere il codice per entrare: in 👥 Utenti attiva 🔒 Richiedi un codice per aprire l'app. Da quel momento all'apertura compare un login: si entra solo col proprio codice (anche tu come Admin). Il codice viene ricordato sul dispositivo (non lo reinserisci ogni volta); con 👁 esci in alto lo dimentichi e torni al login. Conserva il tuo codice Admin: ti serve per rientrare.

⚠️ È una protezione blanda lato browser (nasconde i comandi e chiede il codice, ma i dati sono comunque nel dispositivo): va bene per uso familiare, non è una sicurezza forte da server.

11. Problemi frequenti

• Ho copiato un video ma non lo vedo: premi ＋ Nuovo → l'app lo trova e te lo propone (serve la cartella collegata).
• Vedo meno video: alcuni sono clip extra dentro le gare col badge 🎬.
• La classifica resta bianca: quel sito non si incorpora, usa ↗ Apri in una scheda.
• Ho perso modifiche: controlla che l'indicatore sia su "Salvato su file" e tieni una sola scheda aperta.
• Rimettere una clip in griglia: aprila dalla gara → ✎ → svuota "Clip extra di…".
• Video verticale: di default è mostrato intero (con bande ai lati). Per una miniatura piena usa 📷 Imposta copertina e scegli l'area col riquadro 16:9.
• Chiavetta USB: copia tutta la cartella CollezioneVideo, funziona offline.