Terminal Gym sul tuo computer

Versione da stampare: PDF. Per copiare i comandi usa questa pagina: nel PDF i comandi lunghi vanno a capo.

Guida facoltativa · novembre 2026 · per chi vuole imparare il terminale di Ubuntu giocando

Riquadri: verde = messaggio per l'assistente IA · rosso = ATTENZIONE · giallo = NON PROVATO (come leggerli)

Prima ti serve: un computer con Ubuntu 24.04 o più recente (guida Installare Ubuntu Desktop), la connessione a internet e circa 15 minuti.

Dopo puoi: giocare a Terminal Gym dal menu delle applicazioni, imparare i comandi un livello alla volta e arrivare più sicuro alla guida Il tuo server di casa, che usa molto il terminale.

Terminal Gym è un gioco libero per imparare il terminale di Ubuntu partendo da zero: la finestra dove si scrivono i comandi invece di cliccare. Ha 7 livelli, dal Principiante al Sei quasi una persona seria. In ogni livello prima riconosci il comando giusto tra due, poi lo scrivi tu, poi lo fai in un terminale vero, dentro il gioco. A ogni risposta giusta cresce una pianta.

Il gioco lavora solo in una cartella sua, ~/palestra-terminale (la palestra). Il simbolo ~ vuol dire la tua cartella personale.

Versione di prova

Questa è la versione 0.2.1. Abbiamo fatto qualche test, ma provalo anche tu: se trovi un errore, una domanda poco chiara o una risposta giusta che il gioco considera sbagliata, scrivici a ProactiveProject@proton.me. Tutti i controlli fatti sono nel documento Verifiche e conformità.

Se usi un assistente IA (per esempio un chatbot)

Copia e incolla questo messaggio insieme alla guida:

"Guidami a installare Terminal Gym seguendo questa guida. Prima chiedimi quale versione di Ubuntu ho (si vede con il comando lsb_release -d). Poi dammi un comando alla volta, aspetta che ti incolli cosa risponde il terminale e confrontalo con 'Cosa deve succedere'. Non chiedermi mai la mia password: quando un comando la chiede, la scrivo io nel terminale e non la incollo qui."

Percorso rapido

Per chi sa già usare il terminale. L'impronta del file è nella pagina Giochi e apprendimento.

sudo apt update && sudo apt install -y python3-gi gir1.2-gtk-4.0 gir1.2-vte-3.91 librsvg2-common wget unzip
cd ~ && wget https://proactiveproject.eu/scarica/terminal-gym-0.2.1-sorgente.zip
sha256sum terminal-gym-0.2.1-sorgente.zip
unzip terminal-gym-0.2.1-sorgente.zip && cd ~/terminal-gym-0.2.1
python3 terminal_gym.py
bash installa.sh

Passo 1 — Apri il terminale

Premi insieme Ctrl+Alt+T.

Cosa deve succedere: si apre una finestra con una riga che finisce con $. Lì scriverai i comandi di questa guida. Per incollare un comando nel terminale usa Ctrl+Shift+V oppure tasto destro → Incolla (Ctrl+V da solo non funziona).

Controlla la versione di Ubuntu:

lsb_release -d

Cosa fa: scrive il nome e la versione del sistema.

Cosa deve succedere: compare una riga come Description: Ubuntu 26.04.1 LTS. Va bene 24.04 o un numero più alto. Se hai una versione più vecchia, leggi il riquadro giallo in fondo.

Passo 2 — Installa i pezzi che servono al gioco

Il gioco è scritto in Python (un linguaggio di programmazione già presente in Ubuntu) e usa GTK (la libreria che disegna le finestre di Ubuntu) e VTE (quella che disegna il terminale). Sono tutti pacchetti dell'archivio ufficiale di Ubuntu.

sudo apt update && sudo apt install -y python3-gi gir1.2-gtk-4.0 gir1.2-vte-3.91 librsvg2-common wget unzip

Cosa fa: sudo vuol dire fallo come amministratore; apt update aggiorna l'elenco dei programmi disponibili; apt install installa quelli scritti dopo. La maggior parte di solito c'è già.

Ti chiede la tua password di Ubuntu: mentre la scrivi non compare niente, è normale. Premi Invio.

Cosa deve succedere: alla fine torna la riga con $, senza righe che iniziano con E: (errore). Se un pacchetto era già installato, compare è già alla versione più recente: va bene.

Passo 3 — Scarica il gioco

cd ~ && wget https://proactiveproject.eu/scarica/terminal-gym-0.2.1-sorgente.zip

Cosa fa: cd ~ ti porta nella tua cartella personale; wget scarica il file del gioco lì dentro.

Cosa deve succedere: compare una barra che arriva al 100% e poi una riga con salvato (o saved).

Passo 4 — Controlla l'impronta

L'impronta è una lunga fila di numeri e lettere ricavata dal file: se il file è cambiato anche di una sola lettera, l'impronta è completamente diversa.

sha256sum terminal-gym-0.2.1-sorgente.zip

Cosa fa: calcola l'impronta del file che hai scaricato.

Cosa deve succedere: compare l'impronta seguita dal nome del file. Confrontala con quella scritta nella pagina Giochi e apprendimento: devono essere uguali. Se sono diverse, non andare avanti: cancella il file con rm terminal-gym-0.2.1-sorgente.zip, scaricalo di nuovo e, se sono ancora diverse, scrivici.

Passo 5 — Estrai il gioco

unzip terminal-gym-0.2.1-sorgente.zip && cd ~/terminal-gym-0.2.1

Cosa fa: unzip apre l'archivio e crea la cartella terminal-gym-0.2.1; cd entra nella cartella.

Cosa deve succedere: scorre l'elenco dei file estratti e la riga del terminale ora finisce con ~/terminal-gym-0.2.1$.

Il file .zip non serve più. Se vuoi, cancellalo:

rm ~/terminal-gym-0.2.1-sorgente.zip

Passo 6 — Prova il gioco

python3 terminal_gym.py

Cosa fa: avvia il gioco.

Cosa deve succedere: si apre la finestra di Terminal Gym con la presentazione. Crea il tuo profilo (nome, tema, come preferisci che ti parli) e gioca qualche domanda. Per chiudere, chiudi la finestra: torni al terminale.

ATTENZIONE — nella fase Fai il terminale è vero

Nella terza fase di ogni livello scrivi comandi veri, nel tuo computer. Il gioco prepara gli esercizi solo nella sua cartella ~/palestra-terminale e non usa mai sudo da solo, ma quello che scrivi tu viene eseguito davvero. Resta nella palestra e scrivi solo i comandi che il gioco ti chiede. Gli errori sul terminale si pagano.

Sempre dalla cartella del gioco:

bash installa.sh

Cosa fa: crea due file nella tua cartella personale: la scheda del gioco per il menu e la sua icona. Non usa sudo e non tocca il sistema.

Cosa deve succedere: compare Fatto. Terminal Gym ora è nel menu delle applicazioni. Premi il tasto Super (quello con il logo di Windows), scrivi Terminal Gym e apri il gioco da lì. Se non lo vedi subito, aspetta qualche secondo oppure esci e rientra nella sessione.

Se un giorno sposti la cartella terminal-gym-0.2.1, rilancia bash installa.sh dalla nuova posizione.

Aggiornare a una versione nuova

Quando nella pagina Giochi e apprendimento compare una versione nuova, rifai i passi da 3 a 5 e 7 con il nuovo numero di versione al posto di 0.2.1. I profili e i progressi restano: sono salvati fuori dalla cartella del gioco. Poi puoi cancellare la cartella vecchia (vedi sotto).

Togliere il gioco

Se nel livello 4 hai installato i programmi del gioco (cowsay, figlet, tree, htop), apri il gioco → Impostazioni → Rimetti tutto com'era: ti mostra il comando per toglierli, che scrivi tu nel terminale.
Togli il gioco dal menu e cancella la sua cartella:

cd ~/terminal-gym-0.2.1 && bash disinstalla.sh && cd ~ && rm -r ~/terminal-gym-0.2.1

Cosa fa: toglie la scheda e l'icona dal menu, poi cancella la cartella del gioco.

Cosa deve succedere: compare Fatto. Terminal Gym non è più nel menu.

ATTENZIONE — profili e palestre si cancellano per sempre

I progressi sono in ~/.local/share/palestra-terminale e le palestre in ~/palestra-terminale. Cancellali solo se non vuoi più giocare: con rm -r non passano dal cestino e non si recuperano. Prima controlla di non aver messo nella palestra file tuoi. Se sei sicuro: rm -r ~/.local/share/palestra-terminale ~/palestra-terminale

NON PROVATO da chi ha scritto la guida

Il gioco è stato giocato su Ubuntu 26.04 e provato con controlli automatici su Ubuntu 24.04. Non è stato provato su versioni più vecchie, né su altri sistemi derivati da Debian (per esempio Linux Mint o Debian) o su altri sistemi Linux, dove i pacchetti possono avere nomi diversi. In quei casi controlla nella guida ufficiale di PyGObject (in inglese; un assistente IA può tradurtela) come si installano Python, GTK 4 e VTE sul tuo sistema. Poi segnala cosa non ha funzionato (e cosa ha funzionato) scrivendoci (proactiveproject.eu/progetto): così la guida migliora per tutti.

Se qualcosa non va

Cosa succede	Cosa fare
`E: Impossibile trovare il pacchetto gir1.2-vte-3.91`	La tua versione di Ubuntu è troppo vecchia: serve la 24.04 o più recente. Vedi il riquadro giallo.
`wget: comando non trovato` o `unzip: comando non trovato`	Rifai il passo 2: installa anche quei due programmi.
L'impronta non coincide	Non estrarre il file: cancellalo, riscaricalo e ricontrolla. Se è ancora diversa, scrivici.
`python3: can't open file 'terminal_gym.py'`	Non sei nella cartella del gioco: scrivi `cd ~/terminal-gym-0.2.1` e riprova.
`Namespace Vte not available` o `Namespace Gtk not available`	Manca un pacchetto: rifai il passo 2 e guarda se compaiono errori.
Le piante non si vedono	Manca `librsvg2-common`: rifai il passo 2.
Il gioco non compare nel menu	Esci e rientra nella sessione. Se ancora non c'è, rilancia `bash installa.sh` dalla cartella del gioco.
Nel terminale del gioco Ctrl+C e Ctrl+V non copiano e incollano	Nel terminale si usano Ctrl+Shift+C e Ctrl+Shift+V: Ctrl+C serve a fermare un comando.
Una domanda dice sbagliato ma eri sicuro di avere ragione	Può essere un errore del gioco: scrivici la domanda e cosa avevi scritto.

Dove chiedere aiuto: la comunità italiana di Ubuntu (ubuntu-it.org) ha un forum e una documentazione in italiano.

Testo di questa guida: licenza CC BY-SA 4.0. Puoi copiarlo, tradurlo e modificarlo, anche per pubblicarlo altrove, citando proactiveproject e mantenendo la stessa licenza. Una richiesta, non un obbligo: se migliori la guida, proponi la modifica scrivendoci (proactiveproject.eu/progetto), così il miglioramento arriva a tutti.