Ganimede - Estrattore Frame Video

Ganimede è un'applicazione desktop Windows moderna e facile da usare per estrarre automaticamente frame (immagini) da file video. Non richiede installazioni complicate o configurazioni tecniche - basta scaricare ed eseguire!

---

📋 Cosa Puoi Fare con Ganimede

• ✅ Estrarre immagini da video in modo automatico
• 🎯 Tre modalità intelligenti: estrazione completa, singola immagine o automatica
• 📁 Elaborare più video insieme con una semplice coda
• 🖼️ Vedere l'anteprima delle immagini estratte
• ⚙️ Personalizzare tutto: nomi file, dimensioni, cartelle
• 🔄 Zero configurazione - tutto funziona subito!

---

💻 Cosa Ti Serve

Requisiti Minimi

• Computer: Windows 10 o Windows 11 (64-bit)
• Software: .NET 8 (gratuito, si installa in 2 minuti)
• Spazio disco: 100 MB per l'applicazione + spazio per le tue immagini

Nessun altro software richiesto! Ganimede funziona usando le capacità video già integrate in Windows.

---

📦 Installazione (5 Minuti)

Passo 1: Scarica .NET 8

1. Vai su Download .NET 8
2. Clicca su "Download .NET Desktop Runtime 8.0" (Windows, x64)
3. Esegui il file scaricato e segui l'installazione guidata
4. Riavvia il computer (opzionale ma consigliato)

Come verificare l'installazione:

• Apri il Prompt dei comandi (cerca "cmd" nel menu Start)
• Scrivi dotnet --version e premi Invio
• Dovresti vedere un numero di versione (es. 8.0.0)

Passo 2: Scarica Ganimede

1. Vai alla pagina Releases del progetto
2. Scarica l'ultima versione (file Ganimede-v1.0.zip)
3. Estrai il file ZIP in una cartella (es. C:\Programmi\Ganimede)

Passo 3: Avvia Ganimede

1. Apri la cartella dove hai estratto Ganimede
2. Fai doppio clic su Ganimede.exe
3. Se Windows chiede conferma, clicca "Esegui comunque"

🎉 Fatto! L'applicazione è pronta all'uso.

---

🚀 Guida Rapida (Primi 5 Minuti)

Come Estrarre Immagini da un Video

Metodo Semplice (Per Iniziare)

1. Avvia Ganimede (doppio clic su Ganimede.exe)

2. Scegli dove salvare le immagini

   • Clicca il pulsante 🗂️ "Seleziona Cartella Output" in alto
   • Scegli una cartella (es. Documenti\FramiVideo)
   • Clicca "Seleziona cartella"

3. Aggiungi il tuo video

   • Clicca il pulsante ➕ "Aggiungi Video"
   • Scegli un video dal tuo computer (es. vacanze.mp4)
   • Clicca "Apri"

4. Avvia l'estrazione

   • Clicca il pulsante ▶️ "Avvia Coda" verde in alto
   • Aspetta che la barra di avanzamento arrivi al 100%
   • Vedrai il messaggio "Completato ✅"

5. Guarda le tue immagini

   • Apri la cartella che hai scelto al passo 2
   • Troverai una sottocartella con il nome del video
   • Dentro ci sono tutte le immagini estratte!

Esempio di risultato:

📁 Documenti\FramiVideo\
   └─ 📁 vacanze\
       ├─ 🖼️ vacanze_000001.png
       ├─ 🖼️ vacanze_000002.png
       ├─ 🖼️ vacanze_000003.png
       └─ ... (tante altre!)

Metodo Veloce (Più Video Insieme)

1. Scegli la cartella output (come sopra)

2. Aggiungi tutti i video

   • Clicca 📁 "Importa Cartella"
   • Scegli una cartella con tanti video dentro
   • Ganimede li aggiunge tutti alla coda automaticamente

3. Avvia e aspetta

   • Clicca ▶️ "Avvia Coda"
   • Ganimede elabora tutti i video uno dopo l'altro
   • Puoi vedere il progresso di ciascuno nella lista

---

🎯 Le Tre Modalità di Estrazione

Ganimede può estrarre immagini in tre modi diversi. Puoi scegliere quale usare nelle Impostazioni.

1️⃣ Modalità Completa (Predefinita)

Cosa fa: Estrae tutte le immagini dal video, una per ogni fotogramma.

Quando usarla:

• Vuoi analizzare il video fotogramma per fotogramma
• Stai creando un'animazione
• Hai bisogno di tante immagini per un progetto

Esempio: Un video di 10 secondi a 30 fps = 300 immagini

Pro: Ottieni ogni singolo fotogramma
Contro: Crea tanti file (può richiedere molto spazio disco)

---

2️⃣ Modalità Singola Immagine

Cosa fa: Estrae 1 sola immagine dal centro del video.

Quando usarla:

• Vuoi solo un'anteprima o una copertina del video
• Hai bisogno di velocità (1 secondo per video)
• Vuoi risparmiare spazio su disco

Esempio: Un video di 10 secondi → 1 immagine dall'istante 5 secondi

Pro: Velocissimo, occupa poco spazio
Contro: Solo un'immagine per video

---

3️⃣ Modalità Automatica (Intelligente)

Cosa fa: Ganimede analizza il video e decide automaticamente:

• Video molto breve (≤ 2 secondi) → Estrae 1 sola immagine
• Video breve ma statico (3-45 sec, poco movimento) → Estrae 1 sola immagine
• Altri video → Estrazione completa

Quando usarla:

• Hai una cartella con video di tipi diversi (corti e lunghi)
• Vuoi che Ganimede scelga il metodo migliore automaticamente
• Non sei sicuro quale modalità usare

Esempio:

• Video corto di 1 secondo → 1 immagine
• Video lungo di 5 minuti → tutte le immagini

Pro: Intelligente, ottimizza spazio e tempo automaticamente
Contro: Non hai controllo totale sulla scelta

---

Come Cambiare Modalità:

1. Clicca ⚙️ "Impostazioni" in alto
2. Vai alla sezione "Impostazioni di Elaborazione"
3. Cambia "Modalità di Estrazione Predefinita"
4. Clicca "Salva"

---

⚙️ Impostazioni (Personalizza Come Vuoi)

Aprire le Impostazioni

Clicca il pulsante ⚙️ "Impostazioni" nella barra in alto.

---

Sezione: Output

📁 Crea sottocartella per ogni video

• Cosa fa: Se attivo, crea una cartella separata per ogni video
• Esempio:
  • ✅ Attivo: Output\vacanze\immagine_001.png
  • ❌ Disattivo: Output\immagine_001.png (tutti i video nella stessa cartella)
• Consiglio: Lascia attivo per evitare confusione

📂 Cartella Output Predefinita

• Cosa fa: La cartella dove salvare tutte le immagini estratte
• Come cambiarla: Clicca "Sfoglia" e scegli una nuova cartella
• Consiglio: Usa una cartella facile da ricordare, come Documenti\ImmaginiVideo

---

Sezione: Impostazioni di Elaborazione

📐 Dimensione Immagini

Scegli quanto grandi devono essere le immagini estratte:

Opzione	Risoluzione	Quando Usarla	Dimensione File
Originale	Come il video	Massima qualità	Grande (~1 MB)
1920x1080	Full HD	Video alta qualità	Media (~800 KB)
1280x720	HD	Uso normale	Piccola (~400 KB)
640x360	SD	Anteprime web	Molto piccola (~150 KB)
320x180	Miniatura	Icone/thumbnail	Mini (~56 KB)

Consiglio: Per la maggior parte degli usi, 1280x720 è perfetto (qualità buona, file non troppo grandi).

---

🔄 Comportamento Sovrascrittura

Cosa succede se le immagini esistono già nella cartella:

• Chiedi (predefinito): Ti chiede ogni volta cosa fare
• Salta: Non rielabora, salta le immagini già esistenti (utile per riprendere lavori interrotti)
• Sovrascrivi: Cancella e ricrea tutto (usa se vuoi rigenerare tutto)

Consiglio: Usa "Chiedi" la prima volta, poi "Salta" per risparmiare tempo.

---

🎯 Modalità di Estrazione

Scegli la modalità predefinita (vedi sezione Le Tre Modalità):

• Completa: Tutte le immagini
• Singola Immagine: Solo 1 immagine
• Automatica: Ganimede decide (raccomandato se non sei sicuro)

---

📂 Singolo Frame: Salvataggio

• Cosa fa: Quando usi "Singola Immagine", puoi decidere se creare comunque una sottocartella
• ✅ Attivo: Crea Output\video\video_000001.png
• ❌ Disattivo: Crea Output\video_000001.png (direttamente nella cartella principale)

Consiglio: Lascia disattivo per avere tutte le immagini singole in un unico posto.

---

Sezione: Naming File

🏷️ Come Chiamare i File

Ganimede può chiamare le immagini in modi diversi. Scegli quello che preferisci:

1. VideoNameProgressive (Predefinito)

vacanze_000001.png
vacanze_000002.png
vacanze_000003.png

✅ Usa questo se: Vuoi file ordinati numericamente con il nome del video

2. FrameProgressive

frame_000001.png
frame_000002.png
frame_000003.png

✅ Usa questo se: Non ti interessa il nome del video, vuoi solo numerazione

3. VideoNameTimestamp

vacanze_000000ms.png
vacanze_033ms.png
vacanze_067ms.png

✅ Usa questo se: Vuoi sapere a che secondo del video corrisponde l'immagine

4. CustomProgressive

mio_prefisso_000001.png
mio_prefisso_000002.png
mio_prefisso_000003.png

✅ Usa questo se: Vuoi dare un nome personalizzato ai file

Come personalizzare: Scrivi il tuo prefisso nel campo "Prefisso Custom" (es. foto_vacanze)

5. TimestampOnly

00h00m00s000ms.png
00h00m00s033ms.png
00h00m01s500ms.png

✅ Usa questo se: Vuoi i nomi basati solo sul tempo

6. VideoNameFrameProgressive

vacanze_frame_000001.png
vacanze_frame_000002.png
vacanze_frame_000003.png

✅ Usa questo se: Vuoi il massimo della chiarezza nei nomi

---

Salvare le Impostazioni

Dopo aver fatto le modifiche:

1. Clicca "Salva" in basso
2. La finestra si chiude
3. Le tue impostazioni sono ora attive per tutti i nuovi video!

Nota: I video già in coda mantengono le vecchie impostazioni. Per cambiarle:

• Seleziona i video (checkbox a sinistra)
• Clicca ⚙️ "Configura Selezionati"
• Cambia le impostazioni solo per quei video

---

🛠️ Funzioni Avanzate (Per Utenti Esperti)

Configurare Video Singoli

Se vuoi impostazioni diverse per video specifici:

1. Aggiungi i video alla coda
2. Seleziona i video che vuoi configurare (checkbox a sinistra)
3. Clicca ⚙️ "Configura Selezionati" in alto
4. Nella finestra che appare, puoi cambiare:
   • Cartella di output specifica
   • Dimensione immagini
   • Modalità estrazione
   • Nome file
   • Comportamento sovrascrittura
5. Clicca "Salva"

Esempio pratico:

• Video 1 → Estrazione completa in HD
• Video 2 → Solo 1 immagine piccola
• Video 3 → Estrazione automatica in Full HD

Importare da Cartella

Se hai tanti video in una cartella:

1. Clicca 📁 "Importa Cartella"
2. Scegli la cartella con i video
3. Ganimede aggiunge automaticamente tutti i video supportati
4. Clicca ▶️ "Avvia Coda"

Fermare l'Elaborazione

Se vuoi fermare:

1. Clicca ⏹️ "Ferma" in alto
2. Ganimede finisce l'immagine corrente e poi si ferma
3. Il video in elaborazione viene marcato come "Cancellato"

Pulire la Coda

Dopo aver finito:

• 🧹 "Pulisci Completati": Rimuove solo i video completati/falliti
• 🗑️ "Pulisci Tutto": Svuota completamente la coda

---

💡 Esempi Pratici

Caso 1: Creare una Copertina per Video

Obiettivo: Estrarre 1 immagine da 50 video per creare miniature.

Passi:

1. Impostazioni → Modalità: Singola Immagine
2. Impostazioni → Dimensione: 640x360
3. Importa Cartella → Seleziona cartella con 50 video
4. Avvia Coda
5. Risultato: 50 immagini di copertina in pochi minuti!

---

Caso 2: Estrarre Tutti i Frame da un Video

Obiettivo: Analizzare un video fotogramma per fotogramma.

Passi:

1. Impostazioni → Modalità: Completa
2. Impostazioni → Dimensione: Originale
3. Aggiungi Video → Scegli il video
4. Avvia Coda
5. Risultato: Tutte le immagini in Output\NomeVideo\

---

Caso 3: Batch Automatico (Video Misti)

Obiettivo: Estrarre immagini da video di durata diversa in modo intelligente.

Passi:

1. Impostazioni → Modalità: Automatica
2. Importa Cartella → Seleziona cartella con video misti
3. Avvia Coda
4. Risultato:
   • Video corti → 1 immagine
   • Video lunghi → tutte le immagini
   • Tutto automatico!

---

🔧 Risoluzione Problemi

❌ "L'applicazione non si avvia"

Possibili cause:

• .NET 8 non installato
• File corrotti

Soluzione:

1. Verifica .NET 8:
   • Apri Prompt dei comandi
   • Scrivi dotnet --version
   • Se non vedi un numero, installa .NET 8 (vedi Installazione)
2. Scarica di nuovo Ganimede ed estrai in una nuova cartella
3. Riavvia il computer

---

⏱️ "L'estrazione è molto lenta"

Possibili cause:

• Video in altissima risoluzione (4K)
• Dimensione immagini troppo grande
• Computer lento

Soluzione:

1. Usa dimensione 640x360 o 1280x720 invece di "Originale"
2. Salva le immagini su un disco veloce (SSD) se possibile
3. Elabora pochi video alla volta invece di 50 insieme

---

🖼️ "Le immagini sono nere o rovinate"

Possibili cause:

• Video corrotto
• Codec video non supportato

Soluzione:

1. Prova ad aprire il video con VLC o Windows Media Player
2. Se il video non si apre correttamente, è probabilmente corrotto
3. Se il video funziona ma Ganimede no, prova a convertirlo in MP4 con HandBrake (gratuito)

---

📁 "Errore: Accesso negato"

Possibili cause:

• La cartella output è protetta (es. C:\Programmi)
• Un altro programma ha aperto i file

Soluzione:

1. Cambia cartella output in Documenti o Desktop
2. Chiudi programmi di visualizzazione immagini
3. Se necessario, esegui Ganimede come amministratore:
   • Click destro su Ganimede.exe
   • "Esegui come amministratore"

---

🖼️ "Non vedo l'anteprima delle immagini"

Causa: Pannello anteprima mostra solo le ultime 60 immagini.

Soluzione:

• Aspetta che un video finisca di elaborare
• Le anteprime appariranno automaticamente nella colonna destra
• Se la colonna è vuota, verifica che ci siano effettivamente file PNG nella cartella output

---

🎓 Suggerimenti per Principianti

✅ Cosa Fare Prima di Iniziare

1. Crea una cartella dedicata per le immagini estratte (es. Documenti\ImmaginiDaVideo)
2. Prova con 1 video corto prima di elaborare 100 video
3. Usa la modalità Automatica se non sei sicuro
4. Controlla lo spazio disco disponibile (1 minuto di video Full HD → ~1000 immagini → ~1 GB)

❌ Cosa Evitare

• ❌ Non usare cartelle di sistema come C:\Windows o C:\Programmi
• ❌ Non elaborare 100 video Full HD se hai poco spazio disco (controlla prima!)
• ❌ Non chiudere Ganimede durante l'elaborazione (usa "Ferma" se vuoi interrompere)

💡 Trucchi Utili

• 💡 Seleziona più video (Ctrl+Click o Shift+Click) per configurarli insieme
• 💡 Riprendi lavori interrotti impostando Sovrascrittura su "Salta"
• 💡 Organizza per progetto usando sottocartelle diverse (es. Output\Vacanze, Output\Lavoro)

---

🏗️ Informazioni Tecniche (Per Curiosi)

Come Funziona Ganimede

Ganimede usa Windows Media Foundation (WMF), una tecnologia già presente in Windows 10/11. Per questo non servono installazioni aggiuntive o configurazioni complicate.

Tecnologie usate:

• .NET 8: Framework moderno Microsoft
• WPF: Interfaccia grafica moderna
• Windows Media Foundation: Decodifica video nativa Windows
• C# 12: Linguaggio di programmazione

Caratteristiche tecniche:

• 🚀 Elaborazione video completamente asincrona (non blocca l'interfaccia)
• 🎯 Supporto codec: H.264, H.265/HEVC, VP8, VP9, AV1, MPEG-4, WMV, Motion JPEG
• 📦 Nessuna dipendenza esterna da installare
• 💾 Immagini salvate in formato PNG (qualità lossless)

---

📄 Licenza

Ganimede è distribuito con licenza MIT - puoi usarlo liberamente per scopi personali e commerciali.

---

👤 Supporto e Contatti

Hai bisogno di aiuto?

• 📧 Email: [Inserire email supporto]
• 🐛 Segnala problemi: Issues GitHub
• 💬 Domande: [Forum/Discord]

---

🙏 Ringraziamenti

• Microsoft per .NET e Windows Media Foundation
• Community .NET per supporto e feedback
• Tu per usare Ganimede! 😊

---

🔄 Versioni

v5.0 (Dicembre 2024) - Corrente

• ✅ Implementazione nativa Windows Media Foundation
• ✅ Zero dipendenze esterne
• ✅ Installazione semplificata
• ✅ Performance migliorate con accelerazione hardware

v3.0 (Precedente)

• ✅ Interfaccia dark moderna
• ✅ Sistema coda avanzato
• ✅ Tre modalità di estrazione

---

🎬 Buon Divertimento con Ganimede!

Trasforma i tuoi video in immagini in pochi click! 🚀