Capitolo 1

Primi passi

JustMakeQ è un software di regia multimediale: riproduce in ordine un elenco di "cue" (audio, video, immagine, MIDI, OSC...) nel corso di uno spettacolo, lanciate una a una con il tasto GO.

Installare e avviare JustMakeQ

Scarica l'installer corrispondente al tuo sistema dalla tua area di download, poi avvialo. Al primo avvio compare la schermata iniziale:

La schermata iniziale: creare un nuovo progetto, aprirne uno esistente o riprendere un progetto recente.

Lo stato della licenza compare sotto il logo ("Licenza attivata" in verde). Se non è ancora così, il pulsante "Gestisci la mia licenza" apre l'assistente di attivazione: fai riferimento al file .jmqa ricevuto per e-mail alla creazione dell'account.

Creare un primo progetto

Fai clic su "Nuovo Q" per avviare un progetto vuoto. Si apre la finestra principale, con una cue-list ancora vuota:

La finestra principale: barra di trasporto (GO/Stop/Pause) in alto, pulsanti di aggiunta cue subito sotto, cue-list a sinistra, inspector a destra.

Per aggiungere un cue, fai clic sul suo tipo nella barra "+ Cue" (Audio, Video, Immagine, MIDI, OSC, PJLink, HTTP, Fade, Play, Pause, Stop, Wait, Group, Sep). Compare subito nella cue-list:

È stato appena aggiunto un cue Audio: appare in rosso/arancione finché non è associato alcun file.

Fai clic sul cue nell'elenco per aprirlo nell'inspector (a destra): è lì che si regolano tutti i suoi parametri, a partire dal file da riprodurre, nella scheda "Impostazioni".

Un cue selezionato: l'inspector mostra la sua identità (nome, numero, colore) e il suo timing (pre-wait, post-wait, auto-follow/auto-continue).

Avviare lo spettacolo

• Spazio o il pulsante GO: lancia il cue sotto il cursore di riproduzione (il triangolo arancione nella cue-list) e sposta il cursore su quello successivo.
• Esc o il pulsante Stop All: arresta tutto ciò che è in riproduzione.
• P o il pulsante Pause: mette in pausa il cue selezionato; Pause All mette tutto in pausa (nessuna scorciatoia predefinita).
• H o il pulsante Set Head: sposta il cursore di riproduzione sul cue selezionato senza lanciarlo.
• ↓ / ↑: spostano il cursore di riproduzione sul cue successivo/precedente senza lanciarlo.

Queste sono le scorciatoie predefinite: si personalizzano in Preferenze > Scorciatoie da tastiera.

Ogni cue può avere un tempo di pre-attesa (prima di partire) e di post-attesa (prima che il cue successivo si concateni automaticamente, se "Auto-continue" è selezionato). "Auto-follow" lancia il cue successivo immediatamente, senza attendere la fine di quello in corso.

Capitolo 2

Preferenze

Il pulsante "Preferenze" della barra degli strumenti apre una finestra a schede che raccoglie tutte le impostazioni non legate a un progetto specifico (hardware, rete, scorciatoie). Il dettaglio di ogni scheda è riportato di seguito; le Scorciatoie da tastiera hanno un capitolo dedicato (3), così come il controllo tramite IA (13).

Generale

Tema, accelerazione GPU per il video, protezione GO (ritardo minimo anti doppia pressione), comportamento di Stop All (arresto immediato o dissolvenza), opzione di clic sulla cue-list, esportazione/importazione delle impostazioni.

"Esporta le impostazioni..." / "Importa le impostazioni..." (in basso) salvano o trasferiscono in un file tutto ciò che è indipendente dall'hardware (tema, lingua, patch OSC, server, scorciatoie): comodo per duplicare la configurazione su un'altra macchina senza rifare tutte le impostazioni a mano. Schermi, schede audio e superfici video propri di ogni installazione non sono mai inclusi.

Audio > Routing

Ogni uscita fisica (scheda audio) è dichiarata una volta: nome, interfaccia, numero di canali.

Audio > Patch

Ogni canale patch (usato nel mixer di un cue Audio, capitolo 7) si nomina liberamente qui e viene instradato verso un canale reale di un'uscita dichiarata in Routing.

Video > Routing

Ogni uscita fisica (schermo) è nominata una volta; un'immagine di calibrazione (griglia, scacchiera...) può essere lanciata direttamente per verificare l'inquadratura sullo schermo giusto.

Video > Surfaces

Una "superficie" associa una zona rettangolare a un'uscita dichiarata in Routing: è quella che un cue Video/Immagine sceglie come destinazione (capitolo 8). Scheda "Geometria":

Nome, uscita video di destinazione, immagine di calibrazione propria di questa superficie, risoluzione (con pulsante per riprendere quella dell'uscita) e opzione "superficie multiscreen" per estendersi su più uscite.

Scheda "Warp", per correggere la deformazione di una proiezione (parete non piana, angolo del proiettore):

Griglia di deformazione (modo Lineare o Bézier), numero di righe/colonne di punti, spostamento con il mouse (clic e trascina) o da tastiera (frecce, +Shift per un passo di 10px), punto centrale per spostare l'intera superficie, zoom con la rotella.

OSC > Sortant (Patch)

Fino a 6 patch, ciascuno con il suo protocollo, il suo banco (console/software di destinazione), la sua interfaccia di rete sorgente, la sua destinazione e una password opzionale a seconda del protocollo. Usati dai cue OSC (capitolo 10).

OSC > Entrant (Serveur)

Riceve comandi OSC per controllare JustMakeQ a distanza (GO, Stop, Pause, cue successivo/precedente, salto a un numero di cue preciso).

PJLink

Fino a 10 videoproiettori patchati (nome, interfaccia sorgente, destinazione, porta, password opzionale), usati dai cue PJLink (capitolo 11). Il pulsante "?" interroga lo stato del videoproiettore direttamente da questa schermata.

MIDI

Fino a 4 porte di uscita (per i cue MIDI, capitolo 9) e 4 porte di ingresso (scorciatoie MIDI Learn, console di missaggio), aperte automaticamente all'avvio.

Capitolo 3

Scorciatoie tastiera

Preferenze > Scorciatoie da tastiera consente di personalizzare ogni scorciatoia e propone inoltre un "MIDI Learn" per pilotare il trasporto da un controller MIDI fisico (pedaliera, superficie di controllo...).

Scorciatoie da tastiera predefinite, e scorciatoie MIDI Learn appena sotto (un clic su "MIDI Learn" e poi un messaggio CC o Note associa il controllo).

"Ripristina i valori predefiniti" riporta questi valori originali con un clic se una personalizzazione crea problemi.

Capitolo 4

L'interfaccia

La finestra principale si divide in tre zone:

Dall'alto in basso: barra di trasporto, barra di aggiunta cue, poi le tre zone (Media attivi, cue-list, inspector).

• Barra di trasporto (in alto): GO, Stop All, Pause, Pause All, navigazione precedente/successivo, Set Head, poi i pulsanti Inspector, Preferenze, Console (missaggio) e Preview (monitor di anteprima).
• Barra "+ Cue": un pulsante per tipo di cue (vedi capitolo 5) e un lucchetto per bloccare il trascinamento nella cue-list (impedisce il riordino accidentale durante lo spettacolo, senza bloccare l'aggiunta di nuovi file).
• Media attivi (in alto a sinistra): elenco in diretta di ciò che è realmente in riproduzione, indipendentemente dalla posizione del cursore nella cue-list.
• Cue-list (in basso a sinistra): la sequenza dello spettacolo. Colonne: # (numero), Type, Name, Pre/Dur/Post (tempi), loop, marcatore, Notes. Il triangolo arancione indica il cursore di riproduzione (playhead): il prossimo cue che partirà al GO.
• Inspector (a destra): impostazioni del cue selezionato, su due schede - "Identità" (nome, numero, colore, timing, auto-follow/auto-continue, comune a tutti i tipi) e "Impostazioni" (specifiche del tipo di cue, vedi capitoli seguenti).

Il menu "☰ File" dà accesso a Nuovo progetto, Apri, Salva, Crea un bundle (raggruppa il progetto e i suoi media in un'unica cartella portatile) e Sessione coworking... (capitolo 16). Il menu "?" apre la guida, i registri di diagnostica e la gestione della licenza.

Capitolo 5

I tipi di cue

JustMakeQ propone 17 tipi di cue, ciascuno con un proprio colore nella cue-list per individuarli a colpo d'occhio:

Dall'alto in basso: Audio, Video, Immagine, MIDI, OSC, PJLink, HTTP, Fade, Group, ciascuno con il proprio colore.

• Audio: riproduzione di un file sonoro, con routing per canale (capitolo 7).
• Video / Immagine: visualizzazione su una superficie di proiezione, con geometria ed effetti (capitolo 8).
• Stream: visualizzazione di un flusso video di rete in diretta su una superficie di proiezione (capitolo 13).
• MIDI: invio di uno o più messaggi MIDI (capitolo 9).
• OSC: invio di un comando OSC, tramite un banco preconfigurato o in manuale (capitolo 10).
• PJLink: controllo di un videoproiettore in rete (capitolo 11).
• HTTP: richiesta web verso un servizio di terze parti, con modelli pronti all'uso (capitolo 12).
• VISCA / ONVIF: controllo pan/tilt/zoom di una telecamera motorizzata (capitolo 14).
• Fade: fa variare progressivamente il volume, l'opacità, la posizione o la velocità di un altro cue già lanciato.
• Play / Pause: lancia o mette in pausa un altro cue preciso, senza far avanzare il cursore di riproduzione principale.
• Stop: arresta un cue preciso (o tutto, se non è scelto alcun bersaglio).
• Wait: semplice pausa cronometrata nella sequenza.
• GoTo: sposta il cursore di riproduzione verso un altro cue dell'elenco (loop, diramazioni).
• Group: raggruppa più cue, riprodotti in sequenza ("Playlist") o tutti insieme ("Simultaneo") - vedi capitolo 6.
• Sep (separatore): semplice riferimento visivo o di capitolo nella cue-list, senza effetto sulla riproduzione; il GO lo scavalca automaticamente.

Capitolo 6

Mandare in scena uno spettacolo

Il cursore di riproduzione (playhead, triangolo arancione) avanza di un cue a ogni GO. Ogni cue può avere un tempo di pre-attesa (prima di partire) e di post-attesa. Due caselle nella scheda Identità controllano il concatenamento automatico:

• Auto-follow: il cue successivo parte immediatamente, senza attendere la fine di quello in corso.
• Auto-continue: il cue successivo parte automaticamente dopo il post-wait, senza premere di nuovo GO.

Un cue disarmato (casella "Armato" deselezionata) rispetta gli stessi ritardi di un cue normale ma non riproduce mai il suo media: utile per le prove senza lanciare un media (video, suono) non ancora pronto, o per disattivare temporaneamente un cue senza eliminarlo. Il suo nome appare barrato nella cue-list.

Gruppi: Playlist o Simultaneo

Un cue Group raggruppa più cue figli (trascinati dentro, o selezionati e poi "Raggruppa" con il clic destro). La modalità si sceglie nella scheda Impostazioni:

La modalità di gruppo si sceglie qui: Playlist (sequenziale) o Simultaneo.

• Playlist (sequenziale): i cue figli si concatenano uno dopo l'altro, ciascuno rispettando il proprio pre/post-wait.
• Simultaneo: tutti i cue figli partono nello stesso momento.

Il gruppo mostra il proprio colore nella cue-list in base alla modalità, e si apre/chiude con i tasti "<"/">" una volta selezionato.

Capitolo 7

Cue Audio

La scheda Impostazioni di un cue Audio consente di scegliere il file, definire un punto di inizio/fine (per riprodurre solo un estratto), un loop, una velocità di riproduzione e il routing verso le uscite fisiche.

File, Inizio/Fine, Loop, Velocità, poi il mixer per canale (Master + canali nominati in Preferenze > Audio).

• Velocità: da 0,25x a 4x, cambia anche l'intonazione (come un nastro a velocità variabile): nessuna correzione di tonalità, volutamente semplice.
• Mixer / Routing: un fader per ogni canale di uscita configurato (nominati in Preferenze > Audio > Routing), più il Master. "Incolla le impostazioni console" riprende i livelli regolati in diretta sulla Console di uscita (capitolo 9).
• Effetti audio (sotto il mixer): equalizzatore bassi/alti, compressore/limitatore, equalizzatore a 16 bande (interfaccia grafica dedicata), riverbero (algoritmico, senza convoluzione) e delay: un solo effetto attivo alla volta per cue.

Un cue Fade che punta a questo cue può far variare progressivamente il volume o la velocità già in corso.

Capitolo 8

Cue Video e Immagine

Prima di lanciare un cue Video o Immagine occorre almeno una "superficie" di proiezione definita in Preferenze > Video > Surfaces (capitolo 2), a sua volta associata a un'uscita fisica (schermo) dichiarata nella scheda Routing.

Una volta disponibile una superficie, il cue Video/Immagine propone:

File, superficie di destinazione, poi Geometria (schermo intero, opacità, scala, posizione, rotazione 3D X/Y/Z).

• Geometria: scala, posizione, rotazione 3D, opacità: animabili progressivamente da un cue Fade.
• Warp (nell'editor di superficie, Preferenze > Video > Surfaces, capitolo 2): deformazione a griglia, per correggere una proiezione su un supporto non piano o un angolo di proiettore.
• Effetti (comune a Video/Immagine, sotto la Geometria): saturazione, contrasto, luminosità, bianco e nero, seppia.
• Velocità di riproduzione (solo Video): da 0,25x a 4x, immagine e audio incorporato restano sincronizzati.

Un cue Immagine condivide la stessa Geometria e gli stessi Effetti di un cue Video (qui con Saturazione selezionata).

Il pulsante "Preview" della barra di trasporto apre un'anteprima composta da tutti i media attualmente attivi sull'uscita scelta, senza lanciare nulla: comodo per verificare un'inquadratura prima dello spettacolo.

Capitolo 9

Cue MIDI e console di missaggio

Un cue MIDI invia uno o più messaggi su una porta di uscita configurata:

Porta di uscita, poi un elenco di messaggi (Note On/Off, Control Change, SysEx, NRPN...), aggiunti o rimossi liberamente.

Le porte si dichiarano in Preferenze > MIDI (fino a 4 uscite e 4 ingressi):

Le porte di ingresso ricevono i comandi MIDI (scorciatoie MIDI Learn, console di missaggio) e si aprono automaticamente all'avvio.

Console di uscita

Il pulsante "Console" della barra di trasporto apre una console di missaggio: Master + 10 canali di uscita, con VU-meter e assegnazione MIDI Learn per fader (per pilotare ogni canale da un controller fisico).

"Copia le impostazioni" riporta questi livelli nel mixer di un cue Audio selezionato; "Reset tutto a 0 dB" riporta tutti i fader al valore neutro.

Capitolo 10

Cue OSC

Un cue OSC invia un comando a un software o a una console di terze parti. Due modalità nella scheda Impostazioni:

Modalità "Manuale": host/porta/indirizzo OSC inseriti direttamente, con argomenti (Args) il cui tipo - numero, booleano o testo - viene rilevato automaticamente.

• Patch (banco preconfigurato): seleziona un patch dichiarato in Preferenze > OSC > Uscita, poi sceglie un comando da un elenco già adattato al prodotto di destinazione (ETC Eos, QLab, Midas/Behringer, grandMA3, Resolume, OBS...).
• Manuale (host / indirizzo diretto): per un'esigenza non coperta da un banco, con host/porta/indirizzo/argomenti inseriti a mano.

I patch in uscita e il server di ascolto in ingresso si configurano in Preferenze > OSC:

Fino a 6 patch in uscita, ciascuno con il suo protocollo, il suo banco, la sua interfaccia di rete sorgente, la sua destinazione e una password opzionale a seconda del protocollo.

Porte predefinite di JustMakeQ: 53025 (patch generico) e 53026 (server in ingresso locale), volutamente distinte dalle porte predefinite di QLab.

Capitolo 11

Cue PJLink

PJLink è un protocollo di rete standard per pilotare videoproiettori (accensione, spegnimento, selezione ingresso, muto immagine...). I videoproiettori si patchano una volta in Preferenze > PJLink (10 posizioni):

Nome, interfaccia di rete sorgente, indirizzo IP di destinazione, porta e password opzionale per ogni videoproiettore. Il pulsante "?" a fine riga interroga direttamente il videoproiettore (nome, produttore, modello, alimentazione, ingresso attivo, shutter, lampada, errori); la data dell'ultima interrogazione resta visibile nella sua colonna.

Un cue PJLink sceglie poi semplicemente un videoproiettore patchato e un comando:

Il cue si rinomina automaticamente per riflettere il videoproiettore e il comando scelti.

Capitolo 12

Cue HTTP

Il cue HTTP invia una richiesta web (GET/POST/PUT/PATCH/DELETE) verso un servizio di terze parti: utile per pilotare quasi qualsiasi dispositivo o software che esponga una API web (illuminazione connessa, notifiche, domotica...).

La cascata "Prodotto" poi "Azione" propone modelli pronti all'uso; metodo, URL, intestazioni e corpo della richiesta restano liberamente modificabili.

Esistono modelli precompilati per una quindicina di prodotti comuni (vMix, WLED, Bitfocus Companion, Philips Hue, Shelly, Home Assistant, Discord, Pushover, ntfy, telecamere PTZ compatibili PTZOptics...), per evitare di scrivere da soli ogni richiesta. Il campo "Ultima risposta" mostra in diretta la risposta del server, utile per verificare che una richiesta funzioni prima dello spettacolo.

L'opzione "Riprova automaticamente dopo" rilancia la richiesta una sola volta, trascorso il ritardo scelto, se il primo invio fallisce (guasto di rete occasionale): il cue va in errore solo se entrambi i tentativi falliscono.

Capitolo 13

Cue flusso in diretta (Stream)

Il cue Stream mostra un flusso video di rete in diretta su una superficie di proiezione: telecamera IP, encoder o mixer video che espone un flusso standard. Condivide la stessa geometria (posizione, scala, rotazione), gli stessi effetti video e lo stesso missaggio audio (routing per canale, effetti) del cue Video classico (capitolo 8); cambia solo la sorgente.

Protocolli riconosciuti, rilevati automaticamente dal prefisso dell'URL inserito: rtsp://, rtsps://, rtmp://, rtmps://, srt://, rist://, udp://, rtp://, tcp://, oltre a http:///https:// per un flusso HLS (.m3u8) o DASH (.mpd).

Capitolo 14

Cue VISCA e ONVIF (telecamere PTZ)

Due cue dedicati permettono di pilotare una telecamera motorizzata pan/tilt/zoom (PTZ) direttamente da un cue, senza software di terze parti: spostamento, zoom, richiamo e memorizzazione di preset.

VISCA-over-IP

Protocollo binario standard, adottato dalla maggior parte delle telecamere PTZ pro/broadcast (Sony e compatibili). Ogni telecamera si patcha una volta in Preferenze > VISCA (destinazione, porta - 52381 di default -, indirizzo sul bus VISCA da 1 a 7), poi ogni cue VISCA sceglie una telecamera patchata e un comando (pan/tilt nelle 4 direzioni + arresto, zoom avanti/indietro/arresto, posizione home, richiamo o memorizzazione di un preset da 0 a 127).

ONVIF

Standard aperto basato su SOAP/HTTP, diffuso sulle telecamere IP di videosorveglianza e su alcuni modelli broadcast. Ogni telecamera si patcha in Preferenze > ONVIF (destinazione, porta, nome utente/password, profilo media e percorso del servizio: da verificare caso per caso secondo il modello, poiché il valore predefinito non va bene per tutte le marche). Comandi disponibili: spostamento continuo (velocità pan/tilt/zoom regolabili), arresto, posizione home, richiamo/memorizzazione di un preset (identificato da un nome libero, non da un semplice numero come in VISCA).

Capitolo 15

Controllo tramite IA (MCP)

JustMakeQ integra un server MCP (Model Context Protocol) che consente a un assistente IA compatibile (Claude Code, Claude Desktop, Codex...) di pilotare una sessione aperta: elencare, creare, modificare o riordinare i cue, lanciare GO/Stop/Pause.

Disattivato per impostazione predefinita. La porta di ascolto (53020) e l'interfaccia di rete (localhost per default) si impostano qui, così come il token di accesso richiesto per ogni connessione.

Una volta attivato il server, la scheda propone esempi di configurazione pronti da copiare per i principali client IA (comando CLI, file .mcp.json, config.toml).

Capitolo 16

Coworking

Il coworking consente a più tecnici di pilotare la stessa sequenza contemporaneamente da postazioni diverse: un host riproduce realmente i media, i client connessi vedono lo stato in diretta (cue-list, stati, playhead) e possono, secondo il loro livello di permesso, modificare la sequenza o lanciare comandi di trasporto.

Accessibile dal menu File > "Sessione coworking...": avviare una sessione come host, o unirsi a una sessione rilevata automaticamente sulla rete locale. L'host approva manualmente ogni nuova connessione e può regolare in qualsiasi momento il livello di ciascun client (sola lettura, modifica o controllo completo) dalla finestra "Collaboratori".

Capitolo 17

Risoluzione dei problemi

Visualizza i log

Il menu "?" > "Vedere i registri..." apre direttamente la cartella contenente i file di log, con marca temporale a ogni avvio. In caso di crash, quella cartella contiene o un'eccezione Python completa, oppure - per un crash di più basso livello (nativo) - un file separato *_fault.log con lo stack di tutti i thread al momento del guasto. Allegare questi file a qualsiasi richiesta di supporto accelera molto la diagnosi.

Problemi frequenti

• Un cue Video/Immagine non mostra nulla: verificare che una superficie sia effettivamente selezionata nelle sue Impostazioni e che sia associata a un'uscita fisica reale in Preferenze > Video > Routing.
• Nessun suono: verificare l'interfaccia scelta in Preferenze > Audio > Routing e il routing per canale nella scheda Impostazioni del cue.
• Un comando OSC/HTTP/PJLink non parte: il campo "Ultima risposta" (HTTP) o gli indicatori di stato del server in basso a destra nella finestra principale aiutano a confermare che esiste davvero una connessione di rete.
• Licenza: il menu "?" > "Gestisci la licenza" mostra lo stato dettagliato; in caso di errore di rete durante l'attivazione, il messaggio indica ora la causa (orologio di sistema, firewall, DNS, proxy).

Per qualsiasi domanda non trattata qui, la pagina Supporto permette di contattare direttamente il team.