V 3.3.0 Release (#5)

* Add New Script

* chore: auto-update requirements.txt

* Improve user home detection and update Whisper model

Replaced os.getlogin() with USERPROFILE environment variable for more reliable user home directory detection. Updated default Whisper model from 'medium' to 'large-v3' in transcribe_podcast for improved transcription quality.

* Fix indentation in README file tree

Corrected the indentation for the pdf_combiner.py entry in the project file tree for consistency and readability.

* Update "Readme.md"

* - Change the default model to "medium" for better performance
		mod:   scripts/transcribe_wav.sh

* Update Sciript Documentation and README

- mod: "readme.md"
- add: "\docs\pdf_combiner.md"

* chore: auto-update requirements.txt

* Fix Typos
- mod: "README.md"

* Update README
- mod: "README.md"

* Update README

* Update "Readme.md" e "install.ps1"

- Aggiornato `Readme.md` con le istruzioni per l'installazione alternativa.
- Aggiornato `install.ps1` per installare versioni multiple di Python e risolvere problemi di compatibilità.

* Update "Readme.md" e "install.ps1"

- Fix Typo Error nel file "Readme.md"
- Fix installazione Python "install.ps1"

* Update "install.ps1"

- **Rifattorizzazione Script:** Migliorata la rilevazione delle versioni di Python, aggiungendo il tentativo di installazione delle versioni mancanti tramite `winget`.
- **Miglioramento Dipendenze:** Aggiunta una migliore gestione degli errori e strategie di fallback per l'installazione delle dipendenze, anche in caso di mancanza del file `requirements.txt`.
- **Logica e Output:** Migliorato l'output per essere più informativo e la logica per la selezione della migliore versione di Python.
- **Esecuzione `main.py`:** Aumentata la resilienza nell'esecuzione del file `main.py`.

* update "install.ps1"

- Add aggiunta funzione di aggiunta al PATH di windows per utilizzare nativamente Pip e Python

* Update "install.ps1"

- Clean Script Code

* `Readme.md` Fix

* chore: auto-update requirements.txt

* Create tree_size.py

* Update tree_size.py

- Aggiunto supporto login cartelle di rete

* chore: auto-update requirements.txt

* Doc Folder Update

- Update File Documentazione nuovi script
- Fix Nomi file documentazione errati
- Add documentazione mancante

* Del "elenco_cartelle.py"

- Del "elenco_cartelle.py"
- Del Doc "elenco_cartelle.md"
- Eliminazione script elenco cartelle => sostituito dal nuovo "tree_size.py" maggiormente completo e funzionale

* Update README.md

- Backport aggiornamenti fatti in "main"

* Add Funzione Ricorsiva

- Aggiunta Funzione ricorsiva a tutti gli script (una volta completato potrai scegliere se utilizzare lo stesso script di nuovo oppure tornare a "main.py")
- Update "Readme.md"

* Delete requirements.txt

* Update codec_expoler.py

- Fix Error Code

* chore: auto-update requirements.txt

* Update README.md

- Add Sezione "Docs"
- Fix "script" in ordine alfabetico

* Update README.md

- Fix Errore identazione sezione "index Progetto"
- Fix Links sezione "Index Progetto => Docs"

* Update README.md

- Update sezione "Struttura Cartelle"

* Update README.md

- Fix typo

* Update README.md

- Fix Typo

* Update tree_size.py

- Fix Funzione "Filtro Ricerca File" nella pagina di output in html
- Export con nuovo formato '%Y-%m-%d_%H-%M-%S' per avere file unici

* Update README.md

- Preparazione alla RELEASE
- Vari Fix

* Update README.md

- Fix Typo

---------

Co-authored-by: github-actions <[email protected]>

Author: Magnetarman

Docs/elenco_cartelle.md

@@ -0,0 +1,50 @@
+## _Convertitore di Email in PDF 📧➡️📄_ - **eml_converter.py** 🗂️
+
+Uno script Python per convertire file **.eml** (email salvate) in file **PDF**, mantenendo i dettagli importanti del messaggio come oggetto, mittente, destinatario e contenuto del corpo.
+
+---
+
+## Descrizione 📄
+
+Questo **Convertitore di Email in PDF** esplora una cartella specificata dall'utente, trasforma i file **.eml** in HTML leggibile e poi li converte in file **PDF** salvati in una directory dedicata.
+
+Utile per:
+
+- **Archiviazione email** in un formato facilmente consultabile.
+- **Creazione di report** PDF di comunicazioni importanti.
+- **Automatizzare** il processo di conversione email in PDF.
+
+---
+
+## Funzionalità 🌟
+
+- **Conversione automatica**: Legge file **.eml**, genera un HTML e lo salva come PDF.
+- **Output organizzato**: Salva tutti i PDF in una cartella dedicata chiamata **converted_pdfs**.
+- **Dettagli inclusi**: Oggetto, mittente, destinatario e corpo del messaggio preservati nel PDF.
+
+---
+
+## Requisiti 📦
+
+- **wkhtmltopdf**: Strumento esterno necessario per generare PDF. Scaricalo e installalo dal sito ufficiale: [wkhtmltopdf.org](https://wkhtmltopdf.org/).
+
+---
+
+### Esempio Output
+
+```plaintext
+Inserisci il percorso della cartella contenente i file .eml: /percorso/della/cartella
+Converted: email1.eml -> /percorso/della/cartella/converted_pdfs/email1.pdf
+Converted: email2.eml -> /percorso/della/cartella/converted_pdfs/email2.pdf
+Tutti i file .eml sono stati convertiti in PDF nella cartella 'converted_pdfs'.
+```
+
+---
+
+## Note 📝
+
+- **Formati supportati**: Lo script funziona con file **.eml** standard.
+- **Percorsi validi**: Assicurati di fornire un percorso esistente e accessibile.
+- **Output pulito**: Ogni PDF include i dettagli dell'email in un formato leggibile.
+
+---

Docs/eml_converter.md

@@ -1,4 +1,4 @@
-# _Convertitore PNG in JPEG_ - **png_to_jpeg.py** 🖼️➡️🖼️
+# _Convertitore PNG in JPEG_ - **png_converter.py** 🖼️➡️🖼️
 
 Uno script Python che converte automaticamente tutte le immagini `.png` in `.jpg` all'interno di una cartella (e sottocartelle), gestendo correttamente anche le immagini con trasparenza.
 

Docs/png_to_jpeg.md Docs/png_converter.mdDocs/png_to_jpeg.md renamed to Docs/png_converter.md

@@ -0,0 +1,71 @@
+## _Trascrizione Automatica Podcast_ - **transcribe_wav.py** 🎙️
+
+Uno script Python che trascrive automaticamente i file audio in formato **.wav** in testo utilizzando il modello Whisper di OpenAI, salvando le trascrizioni e saltando quelle già presenti.
+
+---
+
+### Descrizione 📄
+
+Il progetto **Trascrizione Automatica Podcast** permette di convertire facilmente registrazioni audio in testo leggibile. Lo script verifica se la trascrizione esiste già per ogni file e, se non presente, utilizza il modello Whisper per generarla. Il risultato viene salvato come file di testo nella stessa cartella dell'audio originale.
+
+Utile per:
+
+- **Trascrivere contenuti audio** di podcast o interviste.
+- **Creare archivi testuali** di registrazioni audio.
+- **Risparmiare tempo** evitando di trascrivere manualmente.
+
+---
+
+### Funzionalità 🌟
+
+- **Supporto Python 3.10**: Verifica e forza l'esecuzione con Python 3.10 se necessario.
+- **Installazione automatica di Whisper**: Aggiorna pip e installa (o reinstalla) openai-whisper se non presente.
+- **Trascrizione automatica**: Analizza i file .wav presenti nella cartella specificata.
+- **Skip file già trascritti**: Salta i file che hanno già una trascrizione esistente.
+- **Salvataggio sicuro**: Le trascrizioni vengono salvate come file .txt nella stessa cartella dell'audio.
+- **Gestione errori**: Notifica eventuali errori durante la trascrizione senza interrompere l'esecuzione.
+
+---
+
+#### Esempio Input
+
+```plaintext
+Inserisci il percorso della cartella contenente i podcast: C:\Users\User\Podcasts
+```
+
+Lo script analizzerà tutti i file .wav nella cartella e sottocartelle e genererà i file di trascrizione corrispondenti.
+
+---
+
+### Output 📊
+
+#### Output Terminale
+
+```plaintext
+Trascrizione in corso per episodio1.wav...
+Trascrizione completata per episodio1.wav, salvata in C:\Users\User\Podcasts\episodio1.txt
+Saltato episodio2.wav, il file di trascrizione esiste già.
+Trascrizione completata.
+```
+
+#### Contenuto del File di Output
+
+- Trascrizione testuale del contenuto audio.
+- File salvato nella stessa cartella dell'audio con estensione .txt.
+
+Esempio di visualizzazione:
+
+```plaintext
+Ciao a tutti e benvenuti al nostro podcast.
+Oggi parleremo di tecnologia e innovazione...
+```
+
+---
+
+### Note 📝
+
+- **Percorsi validi**: Verifica che la cartella inserita esista.
+- **Formati supportati**: Attualmente lo script gestisce solo file **.wav**.
+- **Compatibilità**: Assicurarsi di avere Python 3.10 installato.
+- **Output non distruttivo**: Lo script non modifica i file audio originali.
+- **Installazione automatica**: Pip e Whisper vengono aggiornati/installati automaticamente se necessario.

Docs/transcribe_wav.md

@@ -0,0 +1,83 @@
+## _Esportazione Struttura Cartelle Interattiva_ - **tree_size.py** 🌳
+
+Uno script Python che scansiona ricorsivamente una directory (locale o di rete) e genera un **file HTML interattivo** con la struttura completa di cartelle e file, navigabile offline come in “Esplora Risorse” di Windows.
+
+---
+
+### Descrizione 📄
+
+L'**Esportazione Struttura Cartelle Interattiva** permette di catturare una vera e propria “fotografia” della gerarchia di una directory fornita dall’utente. Lo script rileva tutte le sottocartelle e i file, raccogliendo informazioni come:
+
+- Nome della cartella o del file
+- Data di creazione
+- Dimensione leggibile (KB, MB, GB)
+
+Il risultato viene salvato in un **file HTML autocontenuto**, compatibile con qualsiasi dispositivo e consultabile anche se il disco originale non è più disponibile.
+
+Utile per:
+
+- **Consultazione offline** di strutture complesse.
+- **Analisi e report** di directory aziendali o di rete.
+- **Documentazione e backup** della gerarchia di file.
+
+---
+
+### Funzionalità 🌟
+
+- **Scansione ricorsiva completa**: Analizza tutte le sottocartelle e i file fino alla massima profondità.
+- **Supporto UNC Windows**: Gestisce condivisioni di rete richiedendo credenziali se necessario.
+- **Albero interattivo**: Struttura HTML espandibile e collassabile, stile Esplora Risorse.
+- **Filtro ricerca per nome**: Cerca file e cartelle per nome senza considerare data o dimensione.
+- **Output offline e sicuro**: File HTML autocontenuto, con CSS e JavaScript inline, senza collegamenti esterni.
+- **Compatibilità multi-OS**: Funziona su Windows, Linux e macOS.
+- **Dimensioni leggibili**: File e cartelle mostrano dimensione in formato comprensibile (KB, MB, GB).
+- **Date di creazione**: Mostra la data di creazione o ultima modifica dei file e delle cartelle.
+
+---
+
+#### Esempio Input
+
+```plaintext
+Inserisci il percorso: \\server\share\cartella
+```
+
+Lo script analizzerà il percorso inserito (locale o di rete) e genererà un file HTML interattivo della struttura completa.
+
+---
+
+### Output 📊
+
+#### Output Terminale
+
+```plaintext
+Esportazione completata: Export_data_2025-08-29.html
+```
+
+#### Contenuto del File di Output
+
+- Struttura ad albero espandibile/chiudibile
+- Nome di file e cartelle
+- Data di creazione
+- Dimensione leggibile
+- Filtro di ricerca per nome (solo nome, senza considerare data o dimensione)
+
+Esempio di visualizzazione:
+
+```
+▸ Cartella1
+    ▸ SottocartellaA
+        file1.txt  12 KB  2025-08-29 10:30
+    ▸ SottocartellaB
+        file2.pdf  234 KB  2025-08-28 09:15
+▸ Cartella2
+    file3.docx  1.2 MB  2025-08-27 14:20
+```
+
+---
+
+### Note 📝
+
+- **Percorsi validi**: Verifica che il percorso inserito esista e sia accessibile. Su Windows, lo script può richiedere **utente e password** per accesso a condivisioni di rete UNC.
+- **Output non distruttivo**: Lo script non modifica o elimina alcun file o cartella.
+- **Compatibilità offline**: Il file HTML può essere aperto senza collegamento alla directory originale.
+- <del>**Filtro ricerca**: La ricerca agisce solo sui **nomi di file e cartelle**, ignorando data e dimensione.</del> **Attualmente con Bug**