Skip to content

Commit 85ff80d

Browse files
Magnetarmangithub-actions
andauthored
V 3.2.0 Release (#4)
* 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 --------- Co-authored-by: github-actions <[email protected]>
1 parent 22d8297 commit 85ff80d

File tree

6 files changed

+948
-61
lines changed

6 files changed

+948
-61
lines changed

Docs/pdf_combiner.md

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
## 🖼️ _Generazione PDF da Immagini JPEG_ - **pdf_combiner.py**
2+
3+
Uno script Python con interfaccia grafica che consente di selezionare immagini JPEG e convertirle in un **PDF ottimizzato**, pronto per l’archiviazione o la stampa.
4+
5+
---
6+
7+
## Descrizione 📄
8+
9+
L'**Elaboratore di Documenti Scansionati** permette di importare una o più immagini, migliorarne automaticamente la leggibilità e generare un PDF ordinato e pulito.
10+
11+
Ideale per:
12+
13+
- **Digitalizzare documenti cartacei** in modo rapido.
14+
- **Migliorare la leggibilità** di scansioni non perfette.
15+
- **Creare archivi PDF** partendo da immagini di bassa qualità.
16+
17+
---
18+
19+
## Funzionalità 🌟
20+
21+
- **Correzione orientamento**: Rileva automaticamente la rotazione delle pagine.
22+
- **Pulizia avanzata**: Rimuove bordi, rumore e migliora la leggibilità del testo.
23+
- **Conversione bianco/nero**: Per un output chiaro, leggibile e leggero.
24+
- **Interfaccia intuitiva**: Selezione immagini con un semplice click.
25+
- **Output ordinato**: Salva un PDF nella cartella delle immagini, con nome e data.
26+
27+
---
28+
29+
### Esempio di utilizzo 🧪
30+
31+
1. Avvia lo script.
32+
2. Seleziona una o più immagini `.jpeg` o `.jpg`.
33+
3. Clicca su **"Elabora Documenti"**.
34+
4. Attendi la fine del processo: il PDF sarà generato automaticamente.
35+
36+
---
37+
38+
## Output 📊
39+
40+
### Output PDF
41+
42+
- Nome file: `Documenti_Scansionati_YYYYMMDD_HHMMSS.pdf`
43+
- Posizione: stessa cartella delle immagini originali.
44+
45+
### Output Terminale / Log
46+
47+
```plaintext
48+
Immagine 1/3: Analisi immagine...
49+
Immagine 1/3: Correzione orientamento...
50+
Immagine 1/3: Conversione in bianco e nero...
51+
...
52+
Creazione PDF...
53+
Elaborazione completata!
54+
```
55+
56+
## Note 📝
57+
58+
- Compatibilità: Supporta immagini .jpeg, .jpg e .png.
59+
- Performance: Il processo potrebbe richiedere alcuni secondi per immagine.
60+
- Nitidezza & Contrasto: Le funzioni di aumento sono disabilitate per migliorare la leggibilità del testo.

README.md

Lines changed: 35 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
</p>
88
<br>
99
<p align="center">
10-
<img src="https://img.shields.io/badge/version-3.1-blue.svg" alt="versione">
10+
<img src="https://img.shields.io/badge/version-3.2-blue.svg" alt="versione">
1111
<img src="https://img.shields.io/github/last-commit/Magnetarman/Python-Script?style=flat&logo=git&logoColor=white&color=0080ff" alt="last-commit">
1212
<img src="https://img.shields.io/github/languages/top/Magnetarman/Python-Script?style=flat&color=0080ff" alt="repo-top-language">
1313
<img src="https://img.shields.io/github/languages/count/Magnetarman/Python-Script?style=flat&color=0080ff" alt="repo-language-count">
@@ -53,7 +53,7 @@
5353
├── README.md
5454
├── install.ps1
5555
├── main.py
56-
├── Docs
56+
├── Docs
5757
├── pipreqs-config.toml
5858
├── requirements.txt
5959
└── scripts
@@ -69,6 +69,7 @@
6969
├── remove.py
7070
├── sposta_file.py
7171
├── transcribe_wav.py
72+
├── pdf_combiner.py
7273
└── trash.py
7374
```
7475

@@ -152,6 +153,11 @@
152153
<tr>
153154
<td><b><a href='https://github.com/Magnetarman/Python-Script/blob/master/scripts/estensioni.py'>estensioni.py</a></b></td>
154155
<td><code>❯ Analisi e elenco ordinato delle estensioni file in una directory.</code></td>
156+
</tr>
157+
<tr>
158+
<td><b><a href='https://github.com/Magnetarman/Python-Script/blob/master/scripts/pdf_combiner.py'>pdf_combiner.py</a></b></td>
159+
<td><code>❯ Genera PDF da immagini Jpeg.</code></td>
160+
</tr>
155161
</tr>
156162
</table>
157163
</blockquote>
@@ -179,7 +185,7 @@ Utilizza Python-Script seguendo questi step:
179185
❯ git clone https://github.com/Magnetarman/Python-Script
180186
```
181187

182-
2. utilizza il terminale per Navigare fino alla cartella:
188+
2. Utilizza il terminale per Navigare fino alla cartella:
183189

184190
```sh
185191
cd Python-Script
@@ -191,14 +197,38 @@ Utilizza Python-Script seguendo questi step:
191197
❯ py main.py
192198
```
193199

200+
### ⚙️ Installatione Alternativa
201+
202+
1. Clona la repository the Python-Script:
203+
204+
```sh
205+
❯ git clone https://github.com/Magnetarman/Python-Script
206+
```
207+
208+
2. Avvia il terminale in **modalita amministratore**, Naviga fino alla cartella::
209+
210+
```sh
211+
cd Python-Script
212+
```
213+
214+
3. Avvia lo script `install.ps1`:
215+
216+
```sh
217+
❯ ./install.ps1
218+
```
219+
220+
> 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.
221+
194222
---
195223

196224
## 📌 Roadmap
197225

198226
- [x] **`V 3.0`**: <strike>Creazione 'main.py'.</strike>
199227
- [x] **`V 3.1`**: <strike>Refactor 'Readme.md'. Creazione Cartella 'Docs' con la documentazione di ogni script.</strike>
200-
- [ ] **`V 3.2`**: Automatizzare il processo di installazione di Python e dipendenze al 100%.
201-
- [ ] **`V 4.0`**: unificare il tutto in un unico'main.py' con aggiunta di Interfaccia grafica.
228+
- [x] **`V 3.1.1`**: <strike>Aggiunta Script PDF Combiner in versione Stabile.</strike>
229+
- [x] **`V 3.1.2`**: <strike>il wrapper `main.py` aggiunge automaticamente i nuovi script all'avvio.</strike>
230+
- [x] **`V 3.2`**: Automatizzare il processo di installazione di Python e dipendenze al 100%.
231+
- [ ] **`V 4.0`**: unificare il tutto in un unico 'main.py' con aggiunta di Interfaccia grafica.
202232

203233
---
204234

@@ -233,16 +263,6 @@ Utilizza Python-Script seguendo questi step:
233263
8. **Revisione**: Una volta che la tua PR sarà revisionata e approvata, verrà unita ("merged") nel branch principale. Congratulazioni per il tuo contributo!
234264
</details>
235265

236-
<details closed>
237-
<summary>Contributor Graph</summary>
238-
<br>
239-
<p align="left">
240-
<a href="https://github.com{/Magnetarman/Python-Script/}graphs/contributors">
241-
<img src="https://contrib.rocks/image?repo=Magnetarman/Python-Script">
242-
</a>
243-
</p>
244-
</details>
245-
246266
---
247267

248268
## 🎗 Licenza

0 commit comments

Comments
 (0)