GX Whiteboard Studio: lavagna digitale per registrare lezioni su Debian, il manuale completo

di Giux in evidenza 10 min di lettura

GX Whiteboard Studio è una lavagna digitale per Debian che serve a preparare e registrare lezioni e spiegazioni: si disegna con la tavoletta Wacom, si inseriscono immagini e webcam, si organizza il lavoro in scene e si registra la lavagna in video, con l’audio del microfono. È un’applicazione autonoma, scritta in C++17 con Qt6, separata da GX-TXT. Qui sotto c’è il manuale completo della versione 0.1.1, capitolo per capitolo, preceduto da installazione e compilazione.

Il video di presentazione

In breve

  • Versione: 0.1.1 (release GitHub v0.1.1, pacchetto Debian 0.1.1-1)
  • Piattaforma: Debian 13 amd64, XFCE/X11
  • Linguaggio e toolkit: C++17, Qt6
  • Licenza: GNU GPL versione 3 o successiva (GPL-3.0-or-later), Copyright © 2026 GiuxLab
  • Lingue: italiano e inglese (cataloghi gettext, manuali HTML, integrazione desktop)
  • Sorgenti: github.com/giuxlab-hub/gx-whiteboard-studio

Funzioni

Lavagna digitale con supporto Wacom per pressione, penna e gomma, disegno vettoriale, forme, testo, selezione, Undo/Redo, pan e zoom. Immagini PNG/JPEG/WebP trascinabili direttamente da Thunar, box immagini e webcam ridimensionabili, gestione dell’ordine Z dei media e annotazioni sempre sopra.

Webcam USB, sorgenti IP sperimentali RTSP/HTTP-MJPEG, scene multiple, progetti .gxwp, lavagne .gxwb, salvataggio automatico, backup e recupero. Registrazione del canvas con FFmpeg H.264 (libx264 oppure NVIDIA NVENC), microfono selezionabile tramite PulseAudio, Mute, AAC, MKV, conversione MP4 e rapporti diagnostici. Cataloghi gettext, manuali HTML e integrazione desktop in italiano e inglese.

Novità della versione 0.1.1

  • Rimuovere miniature dalla libreria: fai clic destro direttamente sulla miniatura e scegli Rimuovi dalla libreria. Scompare soltanto il riferimento dalla galleria; il file originale e le immagini già incorporate nelle scene non vengono cancellati. La modifica viene conservata nelle preferenze XDG tramite QSettings e sopravvive al riavvio; l’immagine può essere aggiunta nuovamente.
  • Guide offline complete: Aiuto → Guide → Manuale completo (italiano) oppure Manuale completo (inglese). Entrambi i manuali HTML contengono indice e 13 capitoli.
  • Informazioni: versione 0.1.1, autore GiuxLab, copyright (C) 2026 GiuxLab, licenza GPL-3.0-or-later.

Installazione dal pacchetto Debian

Scarica gx-whiteboard-studio_0.1.1-1_amd64.deb dalla release v0.1.1 su GitHub e installalo:

sudo apt install ./gx-whiteboard-studio_0.1.1-1_amd64.deb
gx-whiteboard-studio

L’applicazione compare nel menu Grafica; le associazioni MIME permettono di aprire .gxwp e .gxwb con un doppio clic da Thunar. Il pacchetto contiene l’eseguibile, i cataloghi delle lingue, i manuali HTML, l’icona, il file desktop e le dichiarazioni MIME; non installa servizi in background. Per disinstallare:

sudo apt remove gx-whiteboard-studio

I progetti, i video e le impostazioni XDG non vengono eliminati. SHA-256 del pacchetto 0.1.1-1:

2372e116f95c00c07be0264b6661e1930899d37550dd0e9cd3b1c870469f0a8a

Compilare dai sorgenti

Richiede Debian 13, CMake 3.20+, un compilatore C++17, Qt6, Python 3 per compilare i cataloghi e, per generare il .deb, dpkg-dev e fakeroot.

sudo apt install build-essential cmake qt6-base-dev python3 \
    dpkg-dev fakeroot ffmpeg pulseaudio-utils \
    qt6-qpa-plugins qt6-svg-plugins libxcb-cursor0

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr
cmake --build build --parallel 2
./run-from-source.sh

Le dipendenze del pacchetto Debian sono descritte in docs/DEBIAN_13.md.

Il manuale utente

Il manuale che segue è lo stesso che l’applicazione apre offline da Aiuto → Guide; nel repository è in docs/manual_it.html.

1. Avvio e spazio di lavoro

Apri GX Whiteboard Studio dal menu applicazioni, dalla sezione Grafica o dal terminale con gx-whiteboard-studio. Per aprire un file già salvato fai doppio clic in Thunar sui documenti .gxwp o .gxwb. F11 attiva e disattiva lo schermo intero. La prima barra contiene gli strumenti essenziali; la seconda barra degli strumenti può essere nascosta per aumentare lo spazio.

2. Wacom, disegno e navigazione

Usa la punta della penna per disegnare. Sono disponibili penna, evidenziatore, gomma, linea, freccia, rettangolo, ellisse e testo. Gli elementi vettoriali rimangono sempre sopra immagini e riquadri video. Lo strumento Seleziona serve per spostare e ridimensionare gli oggetti. Zoom +/− è utilizzabile anche con una penna senza rotellina. Il pan consente di spostarsi in un canvas più grande dell’area visualizzata. Il tasto destro trascinato sposta la vista; un clic destro su una box selezionata apre il menu livelli.

3. Immagini e box

Nella sezione Immagini premi Aggiungi per costruire una libreria di miniature. Seleziona l’immagine e premi Inserisci, quindi disegna con la Wacom il rettangolo che deve occupare. In alternativa trascina PNG, JPEG o WebP da Thunar direttamente sul canvas, anche mentre REC è attivo. Le immagini sono copiate, non spostate, e sono incorporate nel progetto. Per una box selezionata puoi usare le otto maniglie, cambiare opacità, mantenere le proporzioni e scegliere Contieni o Ritaglia.

4. Webcam e telecamere IP

In Telecamere seleziona una webcam USB, la risoluzione e gli FPS, quindi premi Avvia e Inserisci box. Nella modalità IP puoi inserire indirizzi RTSP/HTTP/MJPEG e scegliere una sorgente ip0 ecc. La ricerca della subnet è limitata alle reti private e richiede conferma; un indirizzo IP pubblico può essere inserito manualmente. In questa versione non sono supportate credenziali incorporate negli URL. Alcune telecamere protette potrebbero quindi non trasmettere: la scoperta del dispositivo non garantisce l’accesso allo stream.

5. Scene e progetti

Nella sezione Scene puoi creare, duplicare, rinominare ed eliminare scene. Ogni scena conserva i propri disegni, immagini e ordine Z. Il menu File consente di salvare progetti multi-scena in .gxwp e singole lavagne in .gxwb. Le immagini sono incorporate nel file. Le scorciatoie standard sono Ctrl+N (nuovo progetto), Ctrl+O (apri progetto), Ctrl+S (salva). Undo/Redo resta distinto per ogni scena durante la sessione; la cronologia non viene salvata nel file.

6. Registrazione audio e video

Premi REC (Ctrl+Shift+R) per aprire la configurazione. Seleziona un profilo video, encoder H.264 CPU/NVIDIA, percorso MKV, eventuale conversione MP4 e, se desiderato, un microfono PulseAudio. Il microfono viene attivato solo dopo Avvia registrazione. La traccia audio è AAC, insieme al video della lavagna; la finestra di Thunar e gli strumenti dell’applicazione non vengono registrati. Durante REC usa STOP REC per terminare. Se il microfono è attivo, puoi usare Mute (Ctrl+Shift+M). Attendi la finalizzazione prima di chiudere l’applicazione.

7. Diagnostica, salvataggio e recupero

Accanto a ogni registrazione viene creato un rapporto locale nome.mkv.recording-report.json con conteggio dei frame, eventuali scarti e stato della codifica. L’output MKV viene preservato anche se fallisce la conversione MP4. I progetti sono salvati atomicamente e la versione precedente può essere conservata come .gxwp.bak. Il recupero automatico conserva checkpoint nel percorso dati XDG; dopo un’interruzione, l’applicazione può proporre di recuperarli. Se un progetto risulta corrotto, la funzione di recupero del backup richiede di salvarne una copia con un nuovo nome.

Limitazioni note: le telecamere IP con autenticazione non sono state validate. Il programma non invia automaticamente dati su Internet.

8. Scorciatoie principali

ComandoScorciatoia
Registra / interrompiCtrl+Shift+R
MuteCtrl+Shift+M
Salva progettoCtrl+S
Apri progettoCtrl+O
Nuovo progettoCtrl+N
Schermo interoF11
AnnullaCtrl+Z

Software autonomo di GiuxLab. Nessuna modifica al CORE GX-TXT.

Licenza: GNU GPL versione 3 o successiva (GPL-3.0-or-later). Copyright © 2026 GiuxLab. Testo completo nel file LICENSE e nel pacchetto Debian. Nessuna garanzia.

Gestione della libreria: fai clic con il tasto destro del mouse sulla miniatura e scegli Rimuovi dalla libreria. La voce scompare dalla libreria, ma il file originale e le immagini già inserite nelle scene non vengono cancellati. La modifica rimane dopo il riavvio.

Il menu Aiuto → Guide apre i manuali completi in italiano e inglese; Informazioni mostra versione, autore GiuxLab e licenza GNU GPLv3 o successiva.

9. Gestione e pulizia della libreria immagini

La galleria a sinistra è un elenco di riferimenti ai file locali. Le miniature non costituiscono copie dei file originali: le immagini inserite sul canvas vengono invece incorporate nel progetto, così i documenti già salvati non dipendono più dal file originale.

  1. Seleziona Immagini e premi Aggiungi, scegliendo PNG, JPG/JPEG o WebP dal disco.
  2. Per inserire una miniatura, selezionala e premi Inserisci, quindi traccia il rettangolo d’ingombro sulla lavagna; in alternativa trascina l’immagine da Thunar sul canvas.
  3. Per eliminare un riferimento non più utile, fai clic destro esattamente sulla miniatura e scegli Rimuovi dalla libreria.
  4. La miniatura scompare subito e l’elenco viene memorizzato nelle preferenze. Non viene eseguita alcuna operazione di cancellazione sul disco.
  5. Un’immagine rimossa può essere aggiunta di nuovo con Aggiungi; eventuali copie già inserite nelle scene non cambiano.

Attenzione: il pulsante Rimuovi delle proprietà della box sul canvas è diverso dal comando Rimuovi dalla libreria. Il primo riguarda la box selezionata nella scena, il secondo soltanto la miniatura della galleria.

10. Esempio di lezione registrata

  1. Apri un nuovo progetto, seleziona la scena 1 e prepara lo sfondo.
  2. Inserisci grafici o fotografie da Thunar; ridimensiona le box con le maniglie e, se necessario, modifica l’ordine tra i media. I disegni rimarranno sopra i media.
  3. Apri REC, scegli il file MKV e il microfono appropriato, poi avvia. Il desktop e Thunar non vengono acquisiti: viene codificata soltanto l’immagine composita del canvas.
  4. Disegna con la Wacom e aggiungi ulteriori immagini mentre la registrazione è attiva. Puoi anche passare a una nuova scena: il video mostra la scena correntemente visualizzata.
  5. Se necessario utilizza Mute; il comando agisce sulla cattura dell’applicazione, non sull’intero sistema.
  6. Premi STOP REC e attendi la finalizzazione del file. Controlla la presenza dell’MKV e del rapporto .mkv.recording-report.json.
  7. Salva anche il progetto in .gxwp per poter modificare le scene dopo la lezione.

11. Backup, ripristino e file

.gxwp è il formato completo multi-scena; .gxwb salva una lavagna singola. Il salvataggio del progetto è atomico: il sistema evita di sostituire il documento con un file parziale. La precedente versione del progetto può essere conservata come .gxwp.bak. In caso di danno al documento principale, il programma può proporre il recupero del backup, che si apre come nuovo progetto non ancora salvato. Scegli sempre un nuovo nome per il progetto recuperato.

È presente inoltre un checkpoint automatico nella cartella dati XDG dell’applicazione; il salvataggio automatico non sostituisce la normale abitudine di salvare i documenti. Le sorgenti video e le telecamere non vengono attivate automaticamente all’apertura di un progetto.

12. Strumenti, preferenze e diagnostica

Nel menu Impostazioni → Configurazione puoi regolare la lingua e i comportamenti di navigazione. Con Ctrl+B mostri/nascondi la barra laterale e con Ctrl+Shift+T la barra strumenti secondaria. Con Ctrl+0 ripristini l’inquadratura della lavagna, con Ctrl++ e Ctrl+- esegui lo zoom.

Per diagnosticare un filmato controlla il rapporto JSON accanto all’MKV: contiene codice di uscita dell’encoder, numero di frame, scarti ed eventuali avvisi. Quando la conversione MP4 fallisce, l’MKV valido viene conservato. In caso di spazio disco insufficiente l’applicazione tenta un arresto controllato, ma questo non garantisce il recupero del video se il filesystem viene esaurito improvvisamente.

La cattura con encoder NVIDIA NVENC dipende dalla GPU e dai driver effettivamente disponibili; in caso contrario è previsto l’encoder CPU.

13. Guida, versione e licenza

Nel menu Aiuto → Guide puoi scegliere il Manuale completo (italiano) oppure il Manuale completo (inglese), entrambi disponibili localmente anche senza connessione Internet. Nel menu Aiuto → Informazioni trovi la versione, l’autore GiuxLab e la licenza GNU GPL versione 3 o successiva. Il testo integrale è fornito nel pacchetto in /usr/share/doc/gx-whiteboard-studio/LICENSE.

GX Whiteboard Studio è un’applicazione autonoma, non modifica il CORE GX-TXT. Copyright © 2026 GiuxLab. Licenza: GPL-3.0-or-later.

Limitazioni della versione 0.1.1

  1. Le telecamere IP della rete vengono individuate, ma nelle prove lo streaming reale non ha funzionato; l’autenticazione non è stata approfondita. La scoperta del dispositivo non garantisce l’accesso allo stream.
  2. Ogni scena dispone di Undo/Redo indipendente mentre l’applicazione è aperta, ma la cronologia non viene conservata dopo la chiusura. Il contenuto salvato delle scene non ne risente.

Dove trovarlo

#Debian #FFmpeg #GPL #lavagna digitale #Qt6 #registrazione video #Wacom

Lascia un commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *