| # Direzione per lo Sviluppo la Gestione e la Sicurezza dei Sistemi Informativi e l'Innovazione Digitale | |
| ## Transcribe it - Webapp Gradio | |
| ### Descrizione | |
| Questa applicazione web consente di estrarre, modificare e scaricare sottotitoli da file video o audio, con una gestione avanzata dello storico, editor audio, player video custom e robusta gestione degli errori. L'interfaccia è realizzata con Gradio e ottimizzata per la massima semplicità d'uso. | |
| ### Funzionalità principali | |
| - **Upload di file video o audio**: supporto a formati comuni (mp4, mp3, wav, ecc.). | |
| - **Estrazione automatica dell'audio dai video**. | |
| - **Editor audio integrato**: possibilità di modificare la traccia audio prima della generazione sottotitoli. | |
| - **Generazione sottotitoli**: | |
| - Supporto a due motori: Faster Whisper (locale) e OpenAI Whisper (cloud, con gestione API Key). | |
| - Suddivisione automatica dei file audio troppo grandi (>25MB) in segmenti MP3, con trascrizione e ricostruzione automatica. | |
| - Salvataggio sia del file SRT (con tempi) che del file TXT (solo testo puro). | |
| - **Storico processi**: | |
| - Ogni generazione aggiunge due righe: una per il file SRT, una per il TXT. | |
| - Colonna "Tipologia SRT" per distinguere tra SRT con tempi e testo puro. | |
| - Cronologia consultabile e azioni rapide (modifica, download, unione video, elimina). | |
| - **Player video custom**: anteprima del video originale e del video sottotitolato. | |
| - **Player audio**: sempre visibile dopo upload/estrazione e durante la generazione sottotitoli. | |
| - **Editor SRT integrato**: modifica e salvataggio diretto dei sottotitoli. | |
| - **Unione sottotitoli al video**: generazione automatica del video finale con sottotitoli hardcoded. | |
| - **Download**: scarica file SRT, TXT e audio modificato. | |
| - **Loader visivi**: spinner e messaggi di caricamento durante tutte le operazioni lunghe (generazione sottotitoli, merge video, caricamento player). | |
| - **Gestione robusta degli errori**: feedback chiari e nessun crash anche in caso di input non valido o errori API. | |
| - **Compatibilità multipiattaforma**: funziona su Windows, macOS e Linux. | |
| ### Requisiti | |
| - Python 3.8+ | |
| - Dipendenze principali: gradio, moviepy, pydub, pandas, faster-whisper, openai | |
| ### Avvio rapido | |
| 1. Installa le dipendenze: `pip install -r requirements.txt` | |
| 2. Avvia l'app: `python app.py` | |
| 3. Accedi all'interfaccia web tramite il link fornito in console. | |
| ### Note di sicurezza | |
| - La chiave API OpenAI non viene salvata e viene usata solo per la sessione corrente. | |
| - I file temporanei vengono eliminati automaticamente al termine della sessione. | |
| --- | |