Files
Ganimede/README.md
Alberto Balbo 4acaa72d87 Rimosso FFmpeg, aggiunto supporto nativo WMF
- Eliminata la dipendenza da FFmpeg, ora Ganimede utilizza Windows Media Foundation per la gestione video, semplificando l'installazione.
- Aggiunto badge "Zero Dependencies" per evidenziare l'assenza di dipendenze esterne.
- Aggiornata la descrizione dell'app per enfatizzare semplicità e usabilità.
- Riorganizzate sezioni del README: "Indice", "Installazione", "Guida Rapida" e "Modalità di Estrazione".
- Introdotta la sezione "Cosa Ti Serve" con requisiti minimi di sistema.
- Aggiunti esempi pratici e dettagliate opzioni di configurazione.
- Aggiornata la sezione "Risoluzione Problemi" per riflettere i cambiamenti.
- Migliorato il tono generale del documento per renderlo più accessibile.
- Aggiornate le sezioni "Architettura Tecnica", "Licenza", "Ringraziamenti" e "Versioni" per riflettere le modifiche.
2025-12-08 18:12:59 +01:00

565 lines
16 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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! 🚀