Skip to content

Commit 963a3dc

Browse files
MagnetarmanMagnetarman
committed
Doc Folder Update
- Update File Documentazione nuovi script - Fix Nomi file documentazione errati - Add documentazione mancante
1 parent b54a16a commit 963a3dc

File tree

4 files changed

+205
-1
lines changed

4 files changed

+205
-1
lines changed

‎Docs/eml_converter.md‎

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
## _Convertitore di Email in PDF 📧➡️📄_ - **eml_converter.py** 🗂️
2+
3+
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.
4+
5+
---
6+
7+
## Descrizione 📄
8+
9+
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.
10+
11+
Utile per:
12+
13+
- **Archiviazione email** in un formato facilmente consultabile.
14+
- **Creazione di report** PDF di comunicazioni importanti.
15+
- **Automatizzare** il processo di conversione email in PDF.
16+
17+
---
18+
19+
## Funzionalità 🌟
20+
21+
- **Conversione automatica**: Legge file **.eml**, genera un HTML e lo salva come PDF.
22+
- **Output organizzato**: Salva tutti i PDF in una cartella dedicata chiamata **converted_pdfs**.
23+
- **Dettagli inclusi**: Oggetto, mittente, destinatario e corpo del messaggio preservati nel PDF.
24+
25+
---
26+
27+
## Requisiti 📦
28+
29+
- **wkhtmltopdf**: Strumento esterno necessario per generare PDF. Scaricalo e installalo dal sito ufficiale: [wkhtmltopdf.org](https://wkhtmltopdf.org/).
30+
31+
---
32+
33+
### Esempio Output
34+
35+
```plaintext
36+
Inserisci il percorso della cartella contenente i file .eml: /percorso/della/cartella
37+
Converted: email1.eml -> /percorso/della/cartella/converted_pdfs/email1.pdf
38+
Converted: email2.eml -> /percorso/della/cartella/converted_pdfs/email2.pdf
39+
Tutti i file .eml sono stati convertiti in PDF nella cartella 'converted_pdfs'.
40+
```
41+
42+
---
43+
44+
## Note 📝
45+
46+
- **Formati supportati**: Lo script funziona con file **.eml** standard.
47+
- **Percorsi validi**: Assicurati di fornire un percorso esistente e accessibile.
48+
- **Output pulito**: Ogni PDF include i dettagli dell'email in un formato leggibile.
49+
50+
---

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# _Convertitore PNG in JPEG_ - **png_to_jpeg.py** 🖼️➡️🖼️
1+
# _Convertitore PNG in JPEG_ - **png_converter.py** 🖼️➡️🖼️
22

33
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.
44

‎Docs/transcribe_wav.md‎

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
## _Trascrizione Automatica Podcast_ - **transcribe_wav.py** 🎙️
2+
3+
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.
4+
5+
---
6+
7+
### Descrizione 📄
8+
9+
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.
10+
11+
Utile per:
12+
13+
- **Trascrivere contenuti audio** di podcast o interviste.
14+
- **Creare archivi testuali** di registrazioni audio.
15+
- **Risparmiare tempo** evitando di trascrivere manualmente.
16+
17+
---
18+
19+
### Funzionalità 🌟
20+
21+
- **Supporto Python 3.10**: Verifica e forza l'esecuzione con Python 3.10 se necessario.
22+
- **Installazione automatica di Whisper**: Aggiorna pip e installa (o reinstalla) openai-whisper se non presente.
23+
- **Trascrizione automatica**: Analizza i file .wav presenti nella cartella specificata.
24+
- **Skip file già trascritti**: Salta i file che hanno già una trascrizione esistente.
25+
- **Salvataggio sicuro**: Le trascrizioni vengono salvate come file .txt nella stessa cartella dell'audio.
26+
- **Gestione errori**: Notifica eventuali errori durante la trascrizione senza interrompere l'esecuzione.
27+
28+
---
29+
30+
#### Esempio Input
31+
32+
```plaintext
33+
Inserisci il percorso della cartella contenente i podcast: C:\Users\User\Podcasts
34+
```
35+
36+
Lo script analizzerà tutti i file .wav nella cartella e sottocartelle e genererà i file di trascrizione corrispondenti.
37+
38+
---
39+
40+
### Output 📊
41+
42+
#### Output Terminale
43+
44+
```plaintext
45+
Trascrizione in corso per episodio1.wav...
46+
Trascrizione completata per episodio1.wav, salvata in C:\Users\User\Podcasts\episodio1.txt
47+
Saltato episodio2.wav, il file di trascrizione esiste già.
48+
Trascrizione completata.
49+
```
50+
51+
#### Contenuto del File di Output
52+
53+
- Trascrizione testuale del contenuto audio.
54+
- File salvato nella stessa cartella dell'audio con estensione .txt.
55+
56+
Esempio di visualizzazione:
57+
58+
```plaintext
59+
Ciao a tutti e benvenuti al nostro podcast.
60+
Oggi parleremo di tecnologia e innovazione...
61+
```
62+
63+
---
64+
65+
### Note 📝
66+
67+
- **Percorsi validi**: Verifica che la cartella inserita esista.
68+
- **Formati supportati**: Attualmente lo script gestisce solo file **.wav**.
69+
- **Compatibilità**: Assicurarsi di avere Python 3.10 installato.
70+
- **Output non distruttivo**: Lo script non modifica i file audio originali.
71+
- **Installazione automatica**: Pip e Whisper vengono aggiornati/installati automaticamente se necessario.

‎Docs/tree_size.md‎

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
## _Esportazione Struttura Cartelle Interattiva_ - **tree_size.py** 🌳
2+
3+
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.
4+
5+
---
6+
7+
### Descrizione 📄
8+
9+
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:
10+
11+
- Nome della cartella o del file
12+
- Data di creazione
13+
- Dimensione leggibile (KB, MB, GB)
14+
15+
Il risultato viene salvato in un **file HTML autocontenuto**, compatibile con qualsiasi dispositivo e consultabile anche se il disco originale non è più disponibile.
16+
17+
Utile per:
18+
19+
- **Consultazione offline** di strutture complesse.
20+
- **Analisi e report** di directory aziendali o di rete.
21+
- **Documentazione e backup** della gerarchia di file.
22+
23+
---
24+
25+
### Funzionalità 🌟
26+
27+
- **Scansione ricorsiva completa**: Analizza tutte le sottocartelle e i file fino alla massima profondità.
28+
- **Supporto UNC Windows**: Gestisce condivisioni di rete richiedendo credenziali se necessario.
29+
- **Albero interattivo**: Struttura HTML espandibile e collassabile, stile Esplora Risorse.
30+
- **Filtro ricerca per nome**: Cerca file e cartelle per nome senza considerare data o dimensione.
31+
- **Output offline e sicuro**: File HTML autocontenuto, con CSS e JavaScript inline, senza collegamenti esterni.
32+
- **Compatibilità multi-OS**: Funziona su Windows, Linux e macOS.
33+
- **Dimensioni leggibili**: File e cartelle mostrano dimensione in formato comprensibile (KB, MB, GB).
34+
- **Date di creazione**: Mostra la data di creazione o ultima modifica dei file e delle cartelle.
35+
36+
---
37+
38+
#### Esempio Input
39+
40+
```plaintext
41+
Inserisci il percorso: \\server\share\cartella
42+
```
43+
44+
Lo script analizzerà il percorso inserito (locale o di rete) e genererà un file HTML interattivo della struttura completa.
45+
46+
---
47+
48+
### Output 📊
49+
50+
#### Output Terminale
51+
52+
```plaintext
53+
Esportazione completata: Export_data_2025-08-29.html
54+
```
55+
56+
#### Contenuto del File di Output
57+
58+
- Struttura ad albero espandibile/chiudibile
59+
- Nome di file e cartelle
60+
- Data di creazione
61+
- Dimensione leggibile
62+
- Filtro di ricerca per nome (solo nome, senza considerare data o dimensione)
63+
64+
Esempio di visualizzazione:
65+
66+
```
67+
▸ Cartella1
68+
▸ SottocartellaA
69+
file1.txt 12 KB 2025-08-29 10:30
70+
▸ SottocartellaB
71+
file2.pdf 234 KB 2025-08-28 09:15
72+
▸ Cartella2
73+
file3.docx 1.2 MB 2025-08-27 14:20
74+
```
75+
76+
---
77+
78+
### Note 📝
79+
80+
- **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.
81+
- **Output non distruttivo**: Lo script non modifica o elimina alcun file o cartella.
82+
- **Compatibilità offline**: Il file HTML può essere aperto senza collegamento alla directory originale.
83+
- <del>**Filtro ricerca**: La ricerca agisce solo sui **nomi di file e cartelle**, ignorando data e dimensione.</del> **Attualmente con Bug**

0 commit comments

Comments
 (0)