In breve: sì, esiste un unico file eseguibile. WhisPaste pubblica un AppImage per Linux che si avvia senza alcuna installazione, un .deb per Debian e Ubuntu e un tar.gz semplice del pacchetto di release. Il motore di riconoscimento vocale è compilato nel download: non c'è alcun ambiente Python da creare, nessun pip install e nessun passaggio di compilazione.
I tre file Linux, per nome
Ogni release di WhisPaste pubblica su GitHub gli stessi tre artefatti Linux x86_64. Il segnaposto della versione è il numero di release (per esempio 1.3.0); AppImage e .deb vengono inoltre pubblicati con un nome stabile, senza versione, che punta sempre all'ultima release.
WhisPaste-<version>-linux-x64.AppImageFile eseguibile singolo, senza installazione. Indipendente dalla distribuzione — è quello da scegliere se vuoi semplicemente avviare WhisPaste.
Alias senza versione, sempre l'ultima release:
WhisPaste-linux-x64.AppImageWhisPaste-<version>-linux-x64.debPacchetto Debian per Debian e Ubuntu. Si installa in /opt/whispaste con un link simbolico /usr/bin/whispaste, una voce di menu e un'icona.
Alias senza versione, sempre l'ultima release:
WhisPaste-linux-x64.debWhisPaste-<version>-linux-x64.tar.gzIl pacchetto di release semplice: l'eseguibile con le cartelle lib/ e data/. Decomprimilo dove vuoi ed esegui il binario dalla cartella. È anche il sorgente da cui vengono costruiti AppImage, .deb e i manifesti di pacchettizzazione.
AppImage: un file, nessuna installazione
Scarica l'AppImage, rendilo eseguibile ed eseguilo. In un gestore file: clic destro sul file → Proprietà → Permessi → “Consenti esecuzione come programma”, poi doppio clic. Da terminale basta chmod +x sul file e poi avviarlo. Eseguirlo non scrive nulla nelle directory di sistema (solo la configurazione facoltativa dell'Auto-Paste aggiunge una volta una regola uinput con sudo); l'app conserva modelli e impostazioni in ~/.config/whispaste. Per rimuovere WhisPaste, elimina il file.
.deb: il pacchetto di sistema per Debian e Ubuntu
Se preferisci avere WhisPaste nel gestore dei pacchetti, installa il .deb con apt install ./WhisPaste-<version>-linux-x64.deb. Dichiara le proprie dipendenze di runtime (libgtk-3-0, libsecret-1-0, libnotify4, libayatana-appindicator3-1, libasound2, libcurl4, libkeybinder-3.0-0, liblzma5, libc6, zlib1g), quindi apt installa automaticamente tutto ciò che manca. L'app vera e propria finisce in /opt/whispaste ed è di sola lettura lì; modelli e impostazioni restano nella tua cartella home.
Nessun Python, nessuna compilazione, nessun download separato del motore
WhisPaste esegue whisper.cpp nello stesso processo tramite una libreria libwhisper inclusa, che si trova accanto all'eseguibile nel download. Non c'è alcun virtualenv da creare, nessun pip install, nessun toolkit CUDA e nessuna chiamata al compilatore — anche l'accelerazione GPU è già compilata dentro (Vulkan su Linux, che copre NVIDIA, AMD e Intel con un'unica build; solo CPU quando non è presente un driver utilizzabile). Le schede NVIDIA recenti possono aggiungere facoltativamente il pacchetto CUDA dalle impostazioni.
Una cosa viene scaricata una sola volta: il modello vocale vero e proprio, quando avvii il download del modello durante la configurazione, nella cartella ~/.config/whispaste/models/stt. Dopodiché WhisPaste trascrive senza alcuna connessione di rete.
Scorciatoia per l'input vocale su Wayland (GNOME e KDE)
Wayland non permette alle app di intercettare da sole le scorciatoie globali, quindi lascia che sia il desktop a farlo: assegna una scorciatoia personalizzata al comando qui sotto. Il comando inoltra la chiamata all'istanza di WhisPaste in esecuzione ed esce subito. --toggle avvia una registrazione o ferma quella in corso (e avvia prima WhisPaste se non è ancora in esecuzione), --cancel scarta la registrazione in corso. Con l'AppImage usa il percorso completo del file al posto di whispaste. Push-to-talk, che registra mentre tieni premuto il tasto, è disponibile su Linux come opzione sperimentale su X11 e Wayland (GNOME 48+, Plasma 6+).
whispaste --toggle
whispaste --cancelGNOME: Impostazioni → Tastiera → Visualizza e personalizza le scorciatoie → Scorciatoie personalizzate → +. Assegna il nome WhisPaste, inserisci il comando, poi imposta la scorciatoia.
KDE Plasma 6: Impostazioni di sistema → Tastiera → Scorciatoie → Aggiungi nuova → Comando o script..., inserisci il comando e assegna la scorciatoia. Su Plasma 5: Impostazioni di sistema → Scorciatoie → Scorciatoie personalizzate; lì crea una nuova scorciatoia globale di tipo comando/URL con il comando.
Per gli script: anche inviare SIGUSR2 all'istanza in esecuzione attiva il toggle, senza avviare un secondo processo.
pkill -USR2 -x whispasteDi cosa ha bisogno il tuo computer
Una CPU x86_64 a 64 bit e 8 GB di RAM su Ubuntu Linux o una distribuzione comparabile bastano per il modello compact con la sola CPU. Una GPU non è mai obbligatoria; con una scheda dedicata, Vulkan fa arrivare la stessa trascrizione sensibilmente più in fretta. Preferisci compilarlo da solo? Il codice sorgente completo è su GitHub. Oltre a Flutter, serve il passaggio di build del motore vocale descritto in BUILD.md.
Prima di iniziare
- WhisPaste è disponibile come AppImage?
- Sì. Ogni release pubblica WhisPaste-<version>-linux-x64.AppImage per x86_64, più un WhisPaste-linux-x64.AppImage stabile e senza versione che punta sempre all'ultima release. È un unico file eseguibile: rendilo eseguibile e avvialo, senza programma di installazione e senza gestore di pacchetti.
- Posso eseguire WhisPaste su Ubuntu senza installarlo?
- Sì — a questo serve esattamente l'AppImage. Non richiede root, non tocca le directory di sistema e può stare su una chiavetta USB o nella cartella dei download. Solo l'Auto-Paste facoltativo richiede una volta una regola di permessi per /dev/uinput, che configuri con sudo. Alcune distribuzioni più recenti richiedono libfuse2 per avviarlo (vedi la pagina di download). Se preferisci installarlo in modo tradizionale, WhisPaste-<version>-linux-x64.deb è il pacchetto per Debian e Ubuntu, e WhisPaste-<version>-linux-x64.tar.gz è il bundle semplice che puoi decomprimere dove vuoi.
- Mi serve Python per WhisPaste su Linux?
- No. Il motore di riconoscimento vocale è whisper.cpp, compilato in una libreria libwhisper che è inclusa nel download e viene richiamata nello stesso processo. Non c'è alcun interprete Python, nessun virtualenv, nessun pip install e nessun passaggio di compilazione in tutta la configurazione.
- Il riconoscimento vocale funziona offline su Ubuntu?
- Sì. L'unica cosa che richiede la rete è il download iniziale del modello al primo avvio. Una volta che il file del modello si trova in ~/.config/whispaste/models/stt, la trascrizione avviene interamente sul tuo computer: nessun account, nessun passaggio nel cloud, e nessun calo di qualità su una postazione isolata dalla rete.
- Serve una scheda NVIDIA o un'installazione CUDA?
- Nessuna delle due. Su Linux WhisPaste accelera tramite Vulkan, che copre NVIDIA, AMD e Intel con un'unica build, e non c'è alcun toolkit CUDA da installare. Chi ha una scheda NVIDIA recente (serie RTX o GTX 16) può aggiungere facoltativamente il pacchetto CUDA dalle impostazioni. Senza un driver GPU utilizzabile tutto ricade sulla CPU, che è una configurazione supportata e non una modalità di errore.