Installazione

Audiotext è un’app desktop per Windows, macOS e Linux. Trascrive in testo l’audio di file, video di YouTube e registrazioni del microfono, e può tradurlo, riassumerlo e sottotitolarlo.

Scarica l’app

Scarica il file per il tuo sistema dall’ultima versione su GitHub:

Sistema	File
Windows (64 bit)	Audiotext-<version>-windows-x64-setup.exe
macOS 15 o successivo (Apple Silicon)	Audiotext-<version>-macos-arm64.dmg
Linux (x86_64)	Audiotext-<version>-linux-x86_64.tar.gz

L’app include tutto ciò che le serve, FFmpeg compreso.

Windows

Esegui il programma di installazione e segui i passaggi. Non servono permessi di amministratore. Se hai una GPU NVIDIA, seleziona l’opzione per usare la GPU NVIDIA (CUDA): il programma di installazione scaricherà il componente aggiuntivo per GPU, che rende WhisperX molto più veloce. Il programma di installazione non è firmato, quindi Windows SmartScreen potrebbe mostrare un avviso: apri le informazioni aggiuntive e scegli di eseguirlo comunque.

macOS

Apri il file .dmg e trascina Audiotext nella cartella Applicazioni. L’app non è autenticata da Apple, quindi macOS la blocca la prima volta che la apri: vai in Impostazioni di Sistema → Privacy e sicurezza e fai clic su Apri comunque accanto al messaggio su Audiotext. Sui Mac, WhisperX trascrive sulla GPU di Apple Silicon con MLX Whisper, molto più velocemente che sulla CPU, senza alcun componente aggiuntivo. I Mac con processore Intel non sono supportati, perché PyTorch non li supporta più.

Linux

Estrai l’archivio ed esegui il programma di installazione da un terminale:

tar -xzf Audiotext-<version>-linux-x86_64.tar.gz
cd Audiotext-<version>-linux-x86_64
./install.sh

Installa Audiotext per il tuo utente e lo aggiunge al menu delle applicazioni (si può aprire anche con il comando audiotext). Se rileva una GPU NVIDIA, propone di scaricare il componente aggiuntivo per GPU. Esegui ./install.sh --gpu o ./install.sh --cpu per scegliere senza domande, e ./install.sh --uninstall per disinstallarlo (le impostazioni vengono conservate).

Consiglio

Il componente aggiuntivo per GPU è un download di circa 2 GB su Windows e 4 GB su Linux, quindi conviene solo con una GPU NVIDIA. Senza di esso, WhisperX funziona sulla CPU, e la API di Whisper e la API di Google funzionano allo stesso modo. Per passare in seguito dalla versione per CPU a quella per GPU, o viceversa, reinstalla l’app e scegli l’altra opzione.

Nota

La prima volta che trascrivi con WhisperX (il motore predefinito), viene scaricato il suo modello. Occupa da ~75 MB per tiny a ~3 GB per large-v2, quindi può richiedere un po’ di tempo. Le trascrizioni successive iniziano subito.

Requisiti

• WhisperX funziona sul tuo computer. Gira su qualsiasi CPU, ma è molto più veloce su una GPU NVIDIA con CUDA o sulla GPU di un Mac con Apple Silicon. Consulta Motori per scegliere un modello adatto al tuo hardware.
• La API di Whisper e la API di Google funzionano su server remoti, quindi richiedono una connessione a Internet, ma non un hardware potente.
• Per trascrivere dal microfono, il sistema deve rilevare un dispositivo di ingresso.
• Su Linux, registrare e riprodurre audio richiede PortAudio (sudo apt install libportaudio2 su Ubuntu o Debian).

Aggiorna l’app

Quando esce una nuova versione, Audiotext mostra un pulsante La versione … è disponibile nella barra superiore. Fai clic per aprire la pagina della versione, scarica il file per il tuo sistema e installalo come la prima volta: esegui il nuovo programma di installazione su Windows, trascina la nuova app nella cartella Applicazioni su macOS, oppure esegui l’install.sh del nuovo archivio su Linux. La versione precedente viene sostituita, e le impostazioni e la cronologia vengono mantenute, perché sono salvate nella tua cartella di configurazione dell’utente. Se usi il componente aggiuntivo per la GPU, sceglilo di nuovo durante l’installazione.

Per controllare tu stesso se c’è una nuova versione, apri Preferenze → Informazioni → Controlla aggiornamenti. Per non controllare più all’apertura dell’app, disattiva Generale → Controlla automaticamente gli aggiornamenti.

Disinstalla l’app

• Windows: disinstallala da Impostazioni → App, come qualsiasi altra app.
• macOS: trascina Audiotext dalla cartella Applicazioni nel Cestino.
• Linux: esegui ./install.sh --uninstall dalla cartella dell’archivio. Se non ce l’hai più, elimina ~/.local/share/audiotext, ~/.local/bin/audiotext e ~/.local/share/applications/audiotext.desktop.

Le impostazioni, la cronologia e le registrazioni vengono mantenute, quindi le ritrovi se la reinstalli. Per eliminare tutto:

1. Prima di disinstallarla, rimuovi le chiavi API in Preferenze → Chiavi API (fai clic su Cambia… e lascia il campo vuoto), perché sono conservate nell’archivio delle credenziali del sistema.
2. Elimina la tua cartella di configurazione dell’utente.
3. Elimina i modelli scaricati.

Cambia la lingua dell’interfaccia

Audiotext usa la lingua del sistema, se disponibile. Per cambiarla, apri le Preferenze (l’ingranaggio in alto a destra) e scegli una lingua in Generale → Lingua dell’interfaccia.

Eseguilo dal codice sorgente

Se vuoi eseguire il codice più recente o contribuire, consulta Contribuire per preparare il progetto con Python.

Passi successivi

• La tua prima trascrizione spiega la finestra e i passaggi per trascrivere.