New Readme Beta 2

Magnetarman · Magnetarman · commit 5dde302f217d · 2025-06-26T14:51:22.000+02:00
- Add file di documentazione in italiano per gli script
diff --git a/Docs/efolder.md b/Docs/efolder.md
@@ -0,0 +1,72 @@
+## _Trova e Cancella Cartelle Vuote_ - **efolder.py** 🗂️
+
+Uno script Python per individuare e cancellare **cartelle vuote** all'interno di una directory specificata. Lo script esplora ricorsivamente tutte le sottocartelle e fornisce un elenco di quelle vuote, con l'opzione di eliminarle in modo sicuro.
+
+---
+
+### Descrizione 📄
+
+L'**Utility Trova e Cancella Cartelle Vuote** analizza una cartella specificata dall'utente, individua tutte le cartelle vuote e chiede se eliminarle. Questo strumento è utile per:
+
+- **Ottimizzare lo spazio** rimuovendo directory non necessarie.
+- **Pulizia automatica** di cartelle generate in fase di sviluppo o backup.
+- **Organizzazione** di sistemi di file complessi.
+
+Lo script è interattivo e consente di **confermare l'eliminazione** delle cartelle vuote prima di procedere.
+
+---
+
+### Funzionalità 🌟
+
+- **Scansione ricorsiva**: Esplora tutte le sottocartelle di una directory.
+- **Identificazione cartelle vuote**: Elenco chiaro delle directory senza file.
+- **Interattivo**: Chiede conferma prima di procedere con la cancellazione.
+- **Output dettagliato**: Mostra le cartelle vuote trovate e quelle eliminate.
+
+---
+
+#### Esempio Input
+
+```plaintext
+Inserisci il percorso della cartella: /percorso/cartella
+```
+
+Lo script analizzerà la cartella e mostrerà tutte le cartelle vuote trovate, chiedendo se procedere con la loro eliminazione.
+
+---
+
+### Output 📊
+
+#### Cartelle Trovate
+
+```plaintext
+Cartelle vuote trovate:
+/percorso/cartella1
+/percorso/subfolder/cartella2
+
+Numero totale di cartelle vuote trovate: 2
+```
+
+#### Cancellazione Confermata
+
+Se confermi l'eliminazione:
+
+```plaintext
+Cancellato: /percorso/cartella1
+Cancellato: /percorso/subfolder/cartella2
+```
+
+Se scegli di non procedere:
+
+```plaintext
+Operazione annullata.
+```
+
+---
+
+### Note 📝
+
+- **Uso responsabile**: Verifica sempre il percorso inserito per evitare eliminazioni involontarie.
+- **Sicuro**: Lo script non elimina file, solo cartelle vuote.
+
+---
diff --git a/Docs/elenco_cartelle.md b/Docs/elenco_cartelle.md
@@ -0,0 +1,115 @@
+## _Elenco Cartelle di Primo Livello_ - **elenco_cartelle.py** 🗂️
+
+Uno script Python che elenca tutte le **cartelle di primo livello** in una directory specificata dall'utente e salva i risultati in un file di testo.
+
+---
+
+### Descrizione 📄
+
+L'**Elenco Cartelle di Primo Livello** esplora una directory fornita dall'utente e rileva tutte le cartelle contenute al suo interno (escludendo i file). I risultati vengono salvati automaticamente in un file **cartelle_primo_livello.txt** nella stessa directory analizzata.
+
+Utile per:
+
+- **Organizzare file e cartelle** in sistemi complessi.
+- **Raccogliere un elenco delle sottocartelle** per analisi o report.
+- **Verificare rapidamente la struttura** di una directory.
+
+---
+
+### Funzionalità 🌟
+
+- **Scansione mirata**: Elenca solo le cartelle di primo livello.
+- **Output organizzato**: Salva l'elenco delle cartelle in un file di testo.
+- **Semplice e veloce**: Input interattivo con percorsi verificati.
+- **Output sicuro**: Non modifica o elimina alcun file o cartella.
+
+---
+
+#### Esempio Input
+
+```plaintext
+Inserisci il percorso: /percorso/cartella
+```
+
+Lo script analizzerà il percorso inserito e salverà l'elenco delle cartelle di primo livello in un file **cartelle_primo_livello.txt**.
+
+---
+
+### Output 📊
+
+#### Output Terminale
+
+```plaintext
+Risultati salvati in: /percorso/cartella/cartelle_primo_livello.txt
+```
+
+#### Contenuto del File di Output
+
+```plaintext
+Cartelle di primo livello:
+/percorso/cartella1
+/percorso/cartella2
+/percorso/cartella3
+```
+
+Il file **cartelle_primo_livello.txt** verrà generato nella stessa cartella specificata come input.
+
+---
+
+### Note 📝
+
+- **Percorsi validi**: Verifica che il percorso inserito esista e sia una directory valida.
+- **Output non distruttivo**: Lo script non modifica i contenuti della directory.
+
+---
+
+## _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.
+
+---
diff --git a/Docs/estensioni.md b/Docs/estensioni.md
@@ -0,0 +1,61 @@
+## _Estensioni dei File in una Cartella_ - **estensioni.py** 🗂️
+
+Uno script Python che analizza una directory specificata dall'utente ed elenca tutte le **estensioni dei file** presenti, escludendo duplicati e organizzandole in ordine alfabetico.
+
+---
+
+### Descrizione 📄
+
+L'**Estensione dei File in una Cartella** esplora una directory fornita dall'utente e rileva tutte le estensioni dei file (es. `.txt`, `.jpg`, `.pdf`). Questo strumento è utile per:
+
+- **Organizzare** e analizzare rapidamente i tipi di file in una cartella.
+- **Identificare formati presenti** per pulizie o analisi dei dati.
+- **Controllare tipi di file** in sistemi di archiviazione complessi.
+
+Lo script stampa le estensioni trovate direttamente nel terminale.
+
+---
+
+### Funzionalità 🌟
+
+- **Scansione ricorsiva**: Esplora tutti i file nella cartella e sottocartelle.
+- **Filtraggio intelligente**: Elimina duplicati e considera solo estensioni valide.
+- **Ordinamento alfabetico**: Organizza le estensioni per una lettura chiara.
+- **Semplicità d'uso**: Input interattivo e output pulito.
+
+---
+
+#### Esempio Input
+
+```plaintext
+Inserisci il percorso della cartella: /percorso/cartella
+```
+
+Lo script analizzerà la cartella e stamperà le estensioni dei file trovate.
+
+---
+
+### Output 📊
+
+#### Output Terminale
+
+```plaintext
+Estensioni dei file trovate:
+.csv
+.jpg
+.pdf
+.png
+.txt
+```
+
+Le estensioni vengono visualizzate in ordine alfabetico per una lettura chiara e organizzata.
+
+---
+
+### Note 📝
+
+- **Percorsi validi**: Verifica che il percorso inserito esista e sia una directory valida.
+- **Senza duplicati**: Ogni estensione viene mostrata una sola volta.
+- **Ricorsivo**: Esplora anche le sottocartelle.
+
+---
diff --git a/Docs/image_downloader.md b/Docs/image_downloader.md
@@ -0,0 +1,45 @@
+## _Scaricatore di Immagini da Pagina Web 🌐🖼️_ - **image_downloader.py** 🗂️
+
+Uno script Python per **scaricare tutte le immagini** presenti in una pagina web, inclusi i contenuti **Base64** convertiti in PNG o nel loro formato originale.
+
+---
+
+## Descrizione 📄
+
+Questo **Image Downloader** analizza il contenuto HTML di una pagina web, individua tutti i tag `<img>` e scarica le immagini collegate nel formato originale. Gestisce sia immagini con URL assoluti e relativi, sia immagini codificate in Base64.
+
+Utile per:
+
+- **Salvare tutte le immagini** da una pagina web con un click.
+- **Effettuare scraping visivo** per archiviazione o analisi.
+- **Convertire immagini Base64** in file immagine leggibili.
+
+---
+
+## Funzionalità 🌟
+
+- ✅ Rileva immagini standard e in lazy loading (`src`, `data-src`).
+- 🧠 Converte immagini Base64 in file reali, inclusi `.png`.
+- 📁 Crea automaticamente una cartella `export` per l’output.
+- 🔁 Gestisce URL relativi grazie a `urljoin`.
+- 🧽 Pulisce gli URL rimuovendo parametri inutili (`?`).
+
+---
+
+### Esempio Output
+
+```plaintext
+Inserisci l'URL della pagina web: https://esempio.it
+Scaricata: export/logo.png
+Scaricata immagine Base64: export/base64_image_1.png
+```
+
+---
+
+## Note 📝
+
+- Le immagini SVG in Base64 vengono convertite in `.png`.
+- Lo script non scarica risorse dinamiche caricate da JavaScript.
+- Funziona solo con pagine accessibili pubblicamente.
+
+---
diff --git a/Docs/png_to_jpeg.md b/Docs/png_to_jpeg.md
@@ -0,0 +1,57 @@
+# _Convertitore PNG in JPEG_ - **png_to_jpeg.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.
+
+---
+
+## Descrizione 📄
+
+Il **Convertitore PNG in JPEG** esplora ricursivamente una cartella e converte ogni immagine `.png` in formato `.jpg`. Le immagini con trasparenza vengono adattate con sfondo bianco per mantenere la compatibilità JPEG.
+
+Utile per:
+
+- **Ottimizzare immagini per il web**.
+- **Rimuovere trasparenze** non supportate da JPEG.
+- **Convertire rapidamente** grandi quantità di immagini `.png`.
+
+---
+
+## Funzionalità 🌟
+
+- **Conversione ricorsiva**: esplora tutte le sottocartelle.
+- **Sfondo bianco automatico**: per PNG con trasparenza.
+- **Eliminazione automatica dei PNG**: dopo la conversione, il file originale viene eliminato.
+- **Log in tempo reale**: stampa in console i file convertiti e eventuali errori.
+
+---
+
+## Esempio di Utilizzo 🧪
+
+### Avvia lo script:
+
+```bash
+python png_to_jpeg.py
+```
+
+### Inserisci il percorso della cartella da analizzare quando richiesto:
+
+```plaintext
+Inserisci il percorso della cartella da analizzare: /percorso/cartella
+```
+
+### Al termine, vedrai un riepilogo dei file convertiti:
+
+```plaintext
+[✔] Convertito: /img/foto1.png → /img/foto1.jpg
+[✔] Convertito: /img/foto2.png → /img/foto2.jpg
+```
+
+---
+
+## Note 📝
+
+- Le immagini `.png` vengono eliminate dopo la conversione.
+- Le immagini `.png` con trasparenza avranno sfondo bianco.
+- Lo script supporta anche immagini in modalità LA, RGBA, RGB, L.
+
+---
diff --git a/Docs/remove.md b/Docs/remove.md
