New Readme Beta 1

Magnetarman · Magnetarman · commit fdf33a0c4b3d · 2025-06-26T14:42:57.000+02:00
- Change "Readme.md"
- Add "Docs" folder
diff --git a/Docs/audio_extract.md b/Docs/audio_extract.md
@@ -0,0 +1,93 @@
+## _Estrattore Tracce Audio da MKV 🎥🎵_ - **audio_extract.py** 🗂️
+
+Uno script Python per **identificare** e **estrarre tracce audio** da file `.mkv`, singolarmente o in modo ricorsivo da una cartella. Utilizza `ffprobe` per analizzare le tracce e `ffmpeg` per estrarle nel formato `.flac`.
+
+---
+
+## Descrizione 📄
+
+Questo **Estrattore Audio da MKV** consente di selezionare e salvare una traccia audio specifica da un file `.mkv`, mantenendo la qualità del flusso originale grazie alla conversione in `.flac`.
+
+Utile per:
+
+- **Recuperare tracce audio multilingua** da film e serie.
+- **Creare archivi audio** da video in alta qualità.
+- **Automatizzare l'estrazione** da intere directory video.
+
+---
+
+## Funzionalità 🌟
+
+- **Analisi automatica**: mostra tutte le tracce audio disponibili con la lingua (se presente).
+- **Conversione diretta**: estrae la traccia scelta e la salva come file `.flac`.
+- **Supporto directory**: può elaborare cartelle con più file `.mkv`, anche in modo ricorsivo.
+- **Interfaccia interattiva**: guida passo dopo passo tramite input da terminale.
+
+---
+
+## Requisiti 📦
+
+- **ffmpeg** (incluso anche `ffprobe`)
+
+> Assicurati che `ffmpeg` e `ffprobe` siano installati e accessibili tramite il terminale (PATH di sistema).
+
+---
+
+## Utilizzo 🚀
+
+### ▶️ Modalità Singolo File
+
+1. Inserisci il percorso di un file `.mkv` quando richiesto.
+2. Visualizza le tracce disponibili.
+3. Seleziona quella da esportare.
+
+### 📁 Modalità Directory
+
+1. Inserisci il percorso di una cartella.
+2. Indica il numero della traccia da estrarre.
+3. Scegli se elaborare ricorsivamente le sottocartelle.
+
+### Esempio Output
+
+file audio verranno salvati con il seguente formato:
+
+```
+nomefile_trackX.flac
+```
+
+Nello **stesso percorso** del video originale, dove `X` è il numero della traccia selezionata.
+
+---
+
+## Esempio di Utilizzo 🧪
+
+### Singolo File:
+
+```plaintext
+Inserisci il percorso del file MKV o della directory: /video/film.mkv
+
+Tracce audio trovate:
+0: Traccia 0 (ita)
+1: Traccia 1 (eng)
+
+Inserisci il numero della traccia da esportare: 1
+Audio estratto: /video/film_track1.flac
+```
+
+### Cartella:
+
+```plaintext
+Inserisci il percorso del file MKV o della directory: /media/serie_tv
+Inserisci il numero della traccia da esportare: 0
+Vuoi elaborare tutti i file MKV nella directory in modo ricorsivo? (s/n): s
+```
+
+---
+
+## Note 📝
+
+- Funziona solo con file `.mkv`.
+- L'output è sempre in formato `.flac`, ma lo script può essere adattato ad altri formati (`.mp3`, `.wav`, ecc).
+- Le lingue vengono mostrate se disponibili nei metadati.
+
+---
diff --git a/Docs/codec_explorer.md b/Docs/codec_explorer.md
@@ -0,0 +1,66 @@
+## _Analizzatore Codec Video_ - **codec_explorer.py** 🎥📊
+
+Uno strumento grafico interattivo Python che esamina ricorsivamente tutti i video in una directory specificata. Per ogni file video con codec H264 o H265, visualizza:
+
+- Nome file
+- Codec video
+- Risoluzione
+- Bitrate stimato (kbps)
+- Dimensione del file in GB
+
+---
+
+### Descrizione 📄
+
+L'**Analizzatore Codec Video** è una utility intuitiva che analizza i file multimediali, identificando i codec H264 e H265 (HEVC) e fornendo statistiche tecniche dettagliate.
+
+Utile per:
+
+- Classificare e organizzare collezioni video in base al codec.
+- Ottenere rapidamente informazioni tecniche sui propri file multimediali.
+- Esportare i dati raccolti per analisi approfondite (Excel/CSV).
+
+---
+
+### Funzionalità 🌟
+
+- **Riconoscimento automatico dei codec**: Identifica e separa i file in base al codec video (H264 o H265/HEVC).
+- **Analisi tecnica completa**: Utilizza `ffprobe` per recuperare risoluzione, durata e calcolare il bitrate medio.
+- **Interfaccia grafica intuitiva (Tkinter)**: Permette l'esplorazione e la visualizzazione organizzata dei dati.
+- **Esportazione semplice**: Salva i risultati in formato `.xlsx` (Excel) o `.csv`.
+
+---
+
+#### Esempio di Utilizzo 🧪
+
+Passaggi:
+
+1.  Clicca su "Seleziona cartella e analizza".
+2.  Attendi l'analisi dei file video.
+3.  I risultati saranno mostrati in due schede: **Video H264** e **Video H265**.
+4.  Per salvare i dati, clicca su "Esporta in Excel o CSV".
+
+---
+
+### Output 📊
+
+I risultati sono organizzati in due tabelle distinte all'interno dell'interfaccia grafica:
+
+#### Video H264
+
+#### Video H265
+
+Ogni riga contiene le seguenti informazioni:
+
+`Nome File` | `Codec` | `Risoluzione` | `Bitrate (kbps)` | `Dimensione (GB)`
+
+---
+
+### Note 📝
+
+- **File supportati**: `.mp4`, `.mkv`, `.avi`, `.mov`, `.flv` e altri formati compatibili con `ffprobe`.
+- Lo script ignora automaticamente i file con codec diversi da H264 o H265.
+- Per un funzionamento corretto, `ffprobe` deve essere installato nel sistema.
+- ⚠️ **Dipendenza**: Se `ffprobe` non è disponibile, l'analisi dei file fallirà. Si raccomanda di installare `ffmpeg` (che include `ffprobe`) da [ffmpeg.org](https://ffmpeg.org/) o tramite il tuo gestore di pacchetti.
+
+---
diff --git a/Docs/color_palette.md b/Docs/color_palette.md
@@ -0,0 +1,80 @@
+## _Estrattore di Colori Dominanti_ - **color_palette.py** 🎨
+
+Uno script Python che estrae i **colori dominanti** da un'immagine utilizzando il **clustering KMeans** e li visualizza come una palette. Lo script semplifica immagini complesse nei colori più rappresentativi e salva il risultato come una palette PDF.
+
+---
+
+### Descrizione 📄
+
+L'**Estrattore di Colori Dominanti** analizza un'immagine di input, identifica i colori predominanti utilizzando **KMeans** (machine learning) e genera una **palette visiva chiara** salvata come PDF.
+
+Utile per:
+
+- Designer alla ricerca di ispirazione cromatica.
+- Identificare i colori principali in una foto o immagine.
+- Generare palette cromatiche per progetti creativi e grafici.
+
+---
+
+### Funzionalità 🌟
+
+- **Estrazione automatica dei colori**: Rileva i primi N colori dominanti (default: 4).
+- **Supporto immagini versatile**: Gestisce formati RGB, RGBA e scala di grigi.
+- **Visualizzazione intuitiva**: Crea una palette con codici **HEX** chiari e leggibili.
+- **Output in PDF**: Salva la palette cromatica come file **color_palette.pdf**.
+
+---
+
+#### Esempio Input
+
+```plaintext
+Please enter the path to the image: /percorso/immagine.jpg
+```
+
+Lo script elaborerà l'immagine, estrarrà i colori dominanti e salverà la palette cromatica come **color_palette.pdf** nella stessa cartella dell'immagine di input.
+
+---
+
+### Esempio 📊
+
+#### Immagine di Input
+
+Un esempio di immagine (es. tramonto.jpg):  
+![Esempio Immagine](https://via.placeholder.com/300x200.png?text=Esempio+Immagine)
+
+#### Palette di Output
+
+La palette generata viene visualizzata con i colori dominanti e i relativi codici **HEX**:
+
+```plaintext
+Palette Colori:
+------------------------------
+Colore 1: #FF5733
+Colore 2: #C70039
+Colore 3: #900C3F
+Colore 4: #581845
+```
+
+![Esempio Palette](https://via.placeholder.com/400x100.png?text=Palette+Colori)
+
+---
+
+### Output 💽
+
+La palette cromatica viene salvata come file PDF:
+
+```plaintext
+/percorso/immagine/color_palette.pdf
+```
+
+Ogni colore è etichettato con il relativo codice **HEX** per una facile consultazione.
+
+---
+
+### Note 📝
+
+- **Formati supportati**: .jpg, .png, .bmp e altri formati compatibili con Pillow.
+- **Suggerimento**: Per risultati ottimali, usa immagini con colori chiari e ben definiti.
+- Il numero di colori è modificabile cambiando il parametro **num_colors** nello script.
+
+---
diff --git a/README.md b/README.md
