Come installare Kooha Screen Recorder su Ubuntu Linux

Su Ubuntu, Kooha Screen Recorder è una scelta sensata quando vuoi registrare lo schermo senza trascinarti dietro una suite pesante. La parte importante non è solo installarlo, ma capire quale sorgente stai usando, perché su Linux il comportamento cambia parecchio tra pacchetto distribuito, Flatpak, sessione Wayland e sessione X11. Se salti questo passaggio, rischi di trovarti con una GUI che parte ma non vede microfono, non cattura correttamente la finestra o salva file in una posizione inattesa.

La strada più pulita su Ubuntu recente è quasi sempre Flatpak, perché ti porta una versione aggiornata senza dipendere dai tempi del repository della distro. In alcuni casi puoi anche trovare un pacchetto nel software center o in repository terzi, ma per uno strumento come questo preferisco un canale che sia facile da verificare e altrettanto facile da rimuovere. L’obiettivo pratico è semplice: installare, testare la cattura, controllare audio e permessi, poi decidere se tenere la versione corrente o passare a un’altra build.

Scelta del metodo di installazione su Ubuntu

Prima di toccare il sistema, conviene stabilire il contesto. Se usi Ubuntu 22.04, 24.04 o versioni recenti, molto probabilmente sei su GNOME con Wayland attivo di default. Kooha nasce bene in questo scenario, perché sfrutta il portale di screencast del desktop moderno. Se invece sei in una sessione X11, può funzionare comunque, ma alcune integrazioni cambiano e la diagnostica è diversa.

La domanda operativa è: vuoi una installazione rapida e isolata, oppure un pacchetto nativo del sistema? Per uso desktop e test personali, Flatpak è la scelta più robusta. Per ambienti amministrati, dove vuoi tracciare meglio le dipendenze, puoi valutare il packaging disponibile nei repository, ma devi verificare versione e manutenzione. Non do per scontato che il nome del pacchetto sia identico su ogni release: controlla sempre il catalogo locale prima di installare.

Verifica preliminare: sessione grafica, portali e supporto audio

Prima dell’installazione, fai tre controlli rapidi. Servono a evitare il classico caso in cui il programma è installato correttamente ma non registra nulla perché manca un componente della sessione grafica o dell’audio desktop.

1. Verifica la sessione grafica attiva:

echo $XDG_SESSION_TYPE

Atteso: wayland oppure x11. Se il risultato è vuoto, sei probabilmente in una sessione non grafica o in un contesto remoto non adatto alla cattura locale.

1. Controlla che il portale desktop sia presente:

dpkg -l | grep -E 'xdg-desktop-portal|xdg-desktop-portal-gnome'

Atteso: almeno xdg-desktop-portal installato e, su GNOME, anche il backend specifico. Senza portale, molte app moderne di screen recording non riescono a ottenere la superficie da registrare.

1. Controlla se PipeWire è attivo, perché spesso è il percorso corretto per l’audio desktop:

systemctl --user status pipewire pipewire-pulse wireplumber

Atteso: servizi active (running). Se uno dei tre è assente o inattivo, la registrazione può partire senza audio o con sincronizzazione incoerente.

Installazione con Flatpak: percorso consigliato

Se vuoi una procedura lineare, fai così. Prima installi il supporto Flatpak, poi aggiungi il repository Flathub se non è già presente, quindi installi Kooha. È un flusso reversibile e non sporca troppo il sistema base.

1. Installa Flatpak, se non c’è già:

sudo apt update
sudo apt install flatpak

Atteso: nessun errore sui pacchetti e comando flatpak --version funzionante. Se il sistema è minimal o molto vecchio, potresti dover abilitare il repository universe prima di installare.

1. Aggiungi Flathub, se manca:

flatpak remote-list | grep -i flathub || \
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

Atteso: il remote flathub compare nell’elenco. Se il comando fallisce, il problema è quasi sempre rete, proxy o certificazione TLS del sistema, non Kooha.

1. Installa Kooha:

flatpak install flathub io.github.seadve.Kooha

Atteso: conferma dell’installazione e download dei runtime richiesti. Se Flatpak ti propone runtime aggiuntivi, accettali solo se necessari: sono dipendenze normali, non un’anomalia.

1. Avvia l’applicazione:

flatpak run io.github.seadve.Kooha

Atteso: finestra grafica con opzioni di registrazione. Se non compare nulla, verifica il log della sessione con journalctl --user -xe o lancia il comando da terminale per leggere eventuali messaggi a schermo.

Installazione da repository o software center: quando ha senso

In alcuni casi puoi trovare Kooha nel software center di Ubuntu o in un repository della distribuzione. È una strada comoda se lavori su una macchina standardizzata e vuoi ridurre il numero di formati di packaging presenti. Il punto debole è la versione: per un registratore schermo, rimanere troppo indietro può voler dire rincorrere bug già risolti a monte.

Se vuoi verificare cosa offre il sistema, usa una ricerca mirata. Non assumere che il nome nel catalogo sia identico alla pagina web del progetto.

apt search kooha

Se il pacchetto è disponibile, controlla versione e origine prima di installare. In ambito desktop, il criterio non è “c’è quindi va bene”, ma “c’è, è mantenuto e non rompe il resto”.

apt policy kooha

Atteso: una versione coerente con la release Ubuntu e un’origine di repository attendibile. Se vedi un PPA o una sorgente terza, fermati e valuta il rischio di manutenzione nel tempo.

Prima esecuzione: permessi, portale e cattura dello schermo

La prima apertura di Kooha è il momento in cui emergono gli errori veri. In un ambiente moderno, l’app non deve accedere direttamente allo schermo come succedeva con strumenti più vecchi: passa dal portale desktop. Questo è un vantaggio di sicurezza, ma anche un punto in cui può incepparsi tutto se la sessione non è configurata bene.

Quando avvii la registrazione, osserva questi elementi: il selettore dell’area, il fatto che il desktop mostri la richiesta di condivisione schermo, la presenza del microfono o dell’audio di sistema se previsto. Se la finestra non compare o la selezione dell’area non si apre, il problema è quasi sempre nel portale, nel backend GNOME o nella sessione grafica.

Se hai bisogno di un controllo visivo, apri il monitor dei processi e verifica che l’app non resti bloccata in stato zombie o in attesa di input grafico. Non serve una diagnostica pesante: basta capire se il processo parte e poi si ferma, oppure se resta in esecuzione senza produrre output.

ps -ef | grep -i kooha | grep -v grep

Atteso: un processo utente legato alla sessione grafica. Se non compare nulla, l’avvio è fallito prima ancora dell’interfaccia.

Audio di sistema e microfono: dove spesso si sbaglia

La registrazione dello schermo senza audio funziona, ma è spesso inutile. Il punto critico è distinguere tra audio del microfono e audio del sistema. Su Linux moderno, il secondo dipende molto da PipeWire e dal modo in cui il desktop espone il flusso al portale. Su alcune configurazioni la cattura dell’audio di sistema richiede un backend corretto e una sessione pienamente integrata con il DE.

Per verificare il lato audio, non restare nel dubbio. Guarda i dispositivi disponibili e controlla che il server audio utente sia vivo. Se necessario, usa un tool di monitoraggio semplice per capire se il microfono produce segnale quando parli.

pactl info
pactl list short sources
pactl list short sinks

Atteso: server PulseAudio (on PipeWire) o equivalente, sorgenti presenti e livelli coerenti. Se le sorgenti non ci sono, il problema non è Kooha ma la pila audio della sessione.

Problemi tipici e lettura rapida dei sintomi

Tre casi ricorrenti meritano una diagnosi veloce perché fanno perdere tempo a chi parte direttamente dalla GUI.

1. Finestra che si apre ma non registra: spesso portale o backend desktop non coerenti. Verifica xdg-desktop-portal, backend GNOME e sessione Wayland.
2. Registrazione senza audio: controlla PipeWire, microfono selezionato e permessi del portale. Se l’audio di sistema non compare, è un limite della sessione o della configurazione, non un bug casuale.
3. Output salvato ma non trovato: controlla la directory di destinazione scelta nell’app e i permessi sul filesystem. Una home montata in modo insolito o una cartella sincronizzata può cambiare il comportamento.

Se vuoi una verifica molto pratica, dopo una breve registrazione cerca il file prodotto con un nome recente. Questo evita di inseguire la GUI se il salvataggio è finito in una directory diversa da quella che pensavi.

find ~/Videos ~/Scaricati ~/Downloads -maxdepth 1 -type f -mmin -10 2>/dev/null

Atteso: un file video recente. Se non c’è, il punto da indagare è la destinazione di output o un errore in scrittura sul filesystem.

Ottimizzare la qualità senza complicarsi la vita

Per molti casi d’uso non serve spremere ogni parametro. La registrazione dello schermo deve essere leggibile, fluida e con un peso ragionevole. Se fai tutorial, ticket interni o dimostrazioni tecniche, ti basta una combinazione sensata di risoluzione, frame rate e codec. Spingere troppo in alto il frame rate aumenta il carico senza un guadagno reale, soprattutto se registri desktop statici o terminali.

Un criterio utile è questo: se il tuo obiettivo è mostrare procedure di amministrazione, privilegia la chiarezza del testo e la stabilità del file finale. Un 60 fps su un video che mostra pagine web e shell quasi ferma non aggiunge valore, mentre può peggiorare dimensione e compatibilità. Se invece devi registrare animazioni, scrolling pesante o demo di interfacce, alza il frame rate solo dopo un test breve.

La metrica da tenere d’occhio non è “quanto è bello”, ma quanto pesa il file a parità di durata e se la riproduzione resta fluida sul player che usi davvero. Fai sempre un test di 30–60 secondi prima di registrare materiale lungo.

Rimozione pulita e rollback

Se hai installato via Flatpak, la rimozione è semplice e reversibile. È un vantaggio concreto rispetto a installazioni più invasive, perché puoi tornare allo stato precedente senza lasciare mezza configurazione in giro.

flatpak uninstall io.github.seadve.Kooha

Se vuoi pulire anche runtime non più usati, verifica prima cosa è davvero orfano. Non fare pulizie aggressive senza controllo, perché potresti rimuovere componenti condivisi da altre app Flatpak.

flatpak uninstall --unused

Atteso: solo runtime non più referenziati. Se il sistema segnala dipendenze ancora in uso, fermati e controlla l’elenco prima di confermare. Il rollback, in questo caso, è reinstallare lo stesso package o ripristinare il canale usato in precedenza.

Quando conviene usarlo davvero

Kooha ha senso quando vuoi una registrazione del desktop essenziale, con meno frizioni rispetto a strumenti più ingombranti. È adatto a chi produce guide, demo tecniche, brevi video per ticket o documentazione interna. Se il tuo scenario richiede editing avanzato, scene multiple o automazioni complesse, Kooha non è lo strumento centrale: lì stai già andando verso un workflow diverso.

Su Ubuntu, il punto forte non è solo l’installazione in sé, ma il fatto che puoi integrare il recorder in una sessione moderna senza stravolgere il sistema. Se la base grafica è sana, l’installazione è questione di pochi minuti. Se invece qualcosa non funziona, la diagnosi va fatta sulla catena completa: sessione, portale, audio, permessi e output. È questo il pezzo che fa risparmiare tempo, non il click sull’icona.

Se vuoi un approccio pragmatico, ricordati la sequenza giusta: verifica la sessione, installa da Flathub, avvia un test breve, controlla audio e file generato, poi solo dopo passa a registrazioni lunghe. È la differenza tra uno strumento che “sembra funzionare” e uno che sai davvero gestire.