# Ganimede - Estrattore Frame Video

![.NET 8](https://img.shields.io/badge/.NET-8.0-blue)
![WPF](https://img.shields.io/badge/WPF-Windows-lightgrey)
![Zero Dependencies](https://img.shields.io/badge/Dependencies-Zero-green)

**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](https://dotnet.microsoft.com/download/dotnet/8.0)
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](https://192.168.30.23/Alby96/Ganimede/-/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à](#-le-tre-modalità-di-estrazione)):
- **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](#-installazione-5-minuti))
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](https://handbrake.fr/) (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](https://192.168.30.23/Alby96/Ganimede/issues)
- 💬 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! 🚀