Script Python Utili. Gli script sono testati personalmente ed utilizzati giornalmente.

Tool e Tecnologie Utilizzate:

---

👾 Features

Versione 3.0 - Nuovo approccio all'esecuzione: non si esegue più uno script isolato, ma tramite un unico punto d’ingresso interattivo.

Introdotto il file main.py che gestisce:

• L'installazione automatica delle dipendenze dal file requirements.txt.
• Un menu interattivo per scegliere quale script eseguire.
• Organizzazione automatica degli script in ordine alfabetico.
• Breve descrizione affiancata a ciascuno script.
• Migliore gestione e chiarezza degli strumenti disponibili.

---

📁 Struttura Cartelle

└── Python-Script
    ├── .github
    │   └── workflows
    │       └── update-reqs.yml
    ├── LICENSE
    ├── README.md
    ├── install.ps1
    ├── main.py
    └── Docs
        ├── audio_extract.md
        ├── codec_expoler.md
        ├── color_palette.md
        ├── efolder.md
        ├── eml_converter.md
        ├── estensioni.md
        ├── image_downloader.md
        ├── png_converter.md
        ├── remove.md
        ├── sposta_file.md
        ├── transcribe_wav.md
        ├── pdf_combiner.md
        ├── trash.md
        └── tree_size.md
    ├── pipreqs-config.toml
    ├── requirements.txt
    └── scripts
        ├── audio_extract.py
        ├── codec_expoler.py
        ├── color_palette.py
        ├── efolder.py
        ├── eml_converter.py
        ├── estensioni.py
        ├── image_downloader.py
        ├── png_converter.py
        ├── remove.py
        ├── sposta_file.py
        ├── transcribe_wav.py
        ├── pdf_combiner.py
        ├── trash.py
        └── tree_size.py

📂 Index Progetto

PYTHON-SCRIPT

__root__

install.ps1	❯ Installa Python 3.10 e lancia lo script generale "main.py"
main.py	❯ Script Generale con breve descrizione degli script disponibili
requirements.txt	❯ Librerie necessarie al funzionamento degli script

Docs

audio_extract.py	❯ Estrazione tracce audio .flac da file .mkv (anche ricorsiva).
codec_expoler.py	❯ Analizza i file video identifica codec H264 o H265, ne mostra i dettagli e consente l’esportazione.
color_palette.py	❯ Estrazione e salvataggio dei colori in formato PDF dominanti da un'immagine.
efolder.py	❯ Individuazione e rimozione sicura di cartelle vuote in una directory.
eml_converter.py	❯ Conversione di email .eml in PDF con dettagli del messaggio.
estensioni.py	❯ Analisi e elenco ordinato delle estensioni file in una directory.
image_downloader.py	❯ Download immagini da una pagina web, inclusi contenuti Base64.
pdf_combiner.py	❯ Genera PDF da immagini Jpeg.
png_converter.py	❯ Conversione ricorsiva di tutte le immagini PNG in JPEG all'interno di una cartella specificata, gestendo la trasparenza e rimuovendo i file PNG originali.
remove.py	❯ Rimozione file non musicali e pulizia cartelle vuote in una directory.
sposta_file.py	❯ Spostamento file in directory principale e rimozione cartelle vuote.
transcribe_wav.py	❯ Trascrive automaticamente i file audio .wav in testo utilizzando il modello Whisper, salvando le trascrizioni e saltando quelle già esistenti.
trash.py	❯ Spostamento file con nomi specifici in una cartella "duplicati".
tree_size.py	❯ Esporta la "fotografia" completa e interattiva di una struttura di cartelle in un file HTML statico.

scripts

audio_extract.py	❯ Estrazione tracce audio .flac da file .mkv (anche ricorsiva).
codec_expoler.py	❯ Analizza i file video identifica codec H264 o H265, ne mostra i dettagli e consente l’esportazione.
color_palette.py	❯ Estrazione e salvataggio dei colori in formato PDF dominanti da un'immagine.
efolder.py	❯ Individuazione e rimozione sicura di cartelle vuote in una directory.
eml_converter.py	❯ Conversione di email .eml in PDF con dettagli del messaggio.
estensioni.py	❯ Analisi e elenco ordinato delle estensioni file in una directory.
image_downloader.py	❯ Download immagini da una pagina web, inclusi contenuti Base64.
pdf_combiner.py	❯ Genera PDF da immagini Jpeg.
png_converter.py	❯ Conversione ricorsiva di tutte le immagini PNG in JPEG all'interno di una cartella specificata, gestendo la trasparenza e rimuovendo i file PNG originali.
remove.py	❯ Rimozione file non musicali e pulizia cartelle vuote in una directory.
sposta_file.py	❯ Spostamento file in directory principale e rimozione cartelle vuote.
transcribe_wav.py	❯ Trascrive automaticamente i file audio .wav in testo utilizzando il modello Whisper, salvando le trascrizioni e saltando quelle già esistenti.
trash.py	❯ Spostamento file con nomi specifici in una cartella "duplicati".
tree_size.py	❯ Esporta la "fotografia" completa e interattiva di una struttura di cartelle in un file HTML statico.

---

🚀 Getting Started

☑️ Prerequisiti

Prima di iniziare con Python-Script, assicurati che il tuo ambiente di esecuzione soddisfi i seguenti requisiti:

• Linguaggio di Programmazione: Python
• Gestore di Pacchetti: Pip

⚙️ Installatione

Utilizza Python-Script seguendo questi step:

1. Clona la repository the Python-Script:

❯ git clone https://github.com/Magnetarman/Python-Script

2. Utilizza il terminale per Navigare fino alla cartella:

❯ cd Python-Script

3. Lancia "main.py":

❯ py main.py

⚙️ Installatione Alternativa

1. Clona la repository the Python-Script:

❯ git clone https://github.com/Magnetarman/Python-Script

2. Avvia il terminale in modalita amministratore, Naviga fino alla cartella:

❯ cd Python-Script

3. Avvia lo script install.ps1:

❯ ./install.ps1

Lo script install.ps1 avviato installerà Python e dipendenze minimali. Successivamente lo scipt si occuperà di avviare automaticamente il main.py per utilizzare gli script disponibili.

---

📌 Roadmap

• V 3.0: Creazione 'main.py'.
• V 3.1: Refactor 'Readme.md'. Creazione Cartella 'Docs' con la documentazione di ogni script.
• V 3.1.1: Aggiunta Script PDF Combiner in versione Stabile.
• V 3.1.2: il wrapper main.py aggiunge automaticamente i nuovi script all'avvio.
• V 3.2: Automatizzare il processo di installazione di Python e dipendenze al 100%.
• V 3.3: Aggiunti nuovi script, aggiunta documentazione mancante. 'main.py' non viene terminato alla fine di uno script.
• V 4.0: unificare il tutto in un unico 'main.py' con aggiunta di Interfaccia grafica.

---

🔰 Come Contribuire

• 💬 Partecipa alle Discussioni: Condividi le tue idee, fornisci feedback o fai domande.
• 🐛 Segnala Problemi: Segnala i bug trovati o richiedi nuove funzionalità per il progetto \Python-Script`.
• 💡 Invia Pull Request: Revisiona le Pull Request (PR) aperte e invia le tue.

📖 Linee Guida

1. Esegui il Fork della Repository: Inizia facendo il "fork" della repository del progetto sul tuo account GitHub.
2. Clona in Locale: Clona la repository di cui hai fatto il fork sulla tua macchina locale usando un client Git.

   git clone https://github.com/Magnetarman/Python-Script

3. Crea un Nuovo Branch: Lavora sempre su un nuovo "branch", dandogli un nome descrittivo.

   git checkout -b new-feature-x

4. Apporta le Tue Modifiche: Sviluppa e testa le tue modifiche in locale.
5. Esegui il Commit delle Tue Modifiche: Fai il "commit" con un messaggio chiaro che descriva i tuoi aggiornamenti.

   git commit -m 'Implementata nuova funzionalità x.'

6. Esegui il Push su GitHub: Fai il "push" delle modifiche sulla tua repository "fork".

   git push origin nuova-funzionalita-x

7. Invia una Pull Request: Crea una "Pull Request" (PR) verso la repository originale del progetto. Descrivi chiaramente le modifiche e le loro motivazioni.
8. Revisione: Una volta che la tua PR sarà revisionata e approvata, verrà unita ("merged") nel branch principale. Congratulazioni per il tuo contributo!

---

🎗 Licenza

Creato con ❤️ da Magnetarman, potenziato da ChatGPT e grazie ad Antonio Porcelli per avermi inizializzato allo scrivere e capire Python. Licenza MIT.

---