Capítulo 1

Primeiros passos

O JustMakeQ é um software de régie multimédia: reproduz por ordem uma lista de "cues" (áudio, vídeo, imagem, MIDI, OSC...) ao longo de um espetáculo, disparadas uma a uma com a tecla GO.

Instalar e iniciar o JustMakeQ

Descarregue o instalador correspondente ao seu sistema a partir da sua área de descargas e execute-o. No primeiro arranque, é apresentado o ecrã inicial:

O ecrã inicial: criar um novo projeto, abrir um existente ou retomar um projeto recente.

O estado da licença aparece por baixo do logótipo ("Licença ativada" a verde). Se ainda não for o caso, o botão "Gerir a minha licença" abre o assistente de ativação - consulte o ficheiro .jmqa recebido por e-mail aquando da criação da sua conta.

Criar um primeiro projeto

Clique em "Novo Q" para iniciar um projeto vazio. Abre-se a janela principal, com uma cue-list ainda vazia:

A janela principal: barra de transporte (GO/Stop/Pause) no topo, botões de adição de cue logo abaixo, cue-list à esquerda, inspetor à direita.

Para adicionar um cue, clique no seu tipo na barra "+ Cue" (Audio, Vídeo, Imagem, MIDI, OSC, PJLink, HTTP, Fade, Play, Pause, Stop, Wait, Group, Sep). Aparece de imediato na cue-list:

Acabou de ser adicionado um cue de áudio - aparece a vermelho/laranja enquanto não houver ficheiro associado.

Clique no cue na lista para o abrir no inspetor (à direita): é aí que se definem todos os seus parâmetros, a começar pelo ficheiro a reproduzir, no separador "Definições".

Um cue selecionado: o inspetor mostra a sua identidade (nome, número, cor) e o seu tempo (pre-wait, post-wait, auto-follow/auto-continue).

Iniciar o espetáculo

• Espaço ou o botão GO: dispara o cue sob o cursor de reprodução (o triângulo laranja na cue-list) e avança o cursor para o seguinte.
• Esc ou o botão Stop All: para tudo o que está em reprodução.
• P ou o botão Pause: coloca em pausa o cue selecionado; Pause All coloca tudo em pausa (sem atalho por omissão).
• H ou o botão Set Head: move o cursor de reprodução para o cue selecionado sem o disparar.
• ↓ / ↑: movem o cursor de reprodução para o cue seguinte/anterior sem o disparar.

Estes são os atalhos por omissão - podem ser personalizados em Preferências > Atalhos de teclado.

Cada cue pode ter um tempo de pré-espera (antes de arrancar) e de pós-espera (antes de o cue seguinte se encadear automaticamente, se "Auto-continue" estiver assinalado). O "Auto-follow" dispara o cue seguinte de imediato, sem esperar que o atual termine.

Capítulo 2

Preferências

O botão "Preferências" da barra de ferramentas abre uma caixa de diálogo com separadores que reúne todas as definições que não dependem de um projeto específico (hardware, rede, atalhos). O detalhe de cada separador segue abaixo; os Atalhos de teclado têm o seu próprio capítulo (3), tal como o controlo por IA (13).

Geral

Tema, aceleração GPU para o vídeo, proteção GO (atraso mínimo anti-duplo toque), comportamento do Stop All (paragem imediata ou fade), opção de clique na cue-list, exportação/importação das definições.

"Exportar as definições..." / "Importar as definições..." (em baixo) guardam ou transferem para um ficheiro tudo o que é independente do hardware (tema, idioma, patches OSC, servidores, atalhos) - prático para duplicar a configuração noutra máquina sem refazer todas as definições à mão. Os ecrãs, placas de som e superfícies de vídeo próprios de cada instalação nunca são incluídos.

Audio > Routing

Cada saída física (placa de som) é declarada uma vez: nome, interface, número de canais.

Audio > Patch

Cada canal patch (usado no mixer de um cue de áudio, capítulo 7) é nomeado livremente aqui e encaminhado para um canal real de uma saída declarada em Routing.

Vídeo > Routing

Cada saída física (ecrã) é nomeada uma vez; um padrão de calibração (grelha, xadrez...) pode ser lançado diretamente para verificar o enquadramento no ecrã certo.

Vídeo > Surfaces

Uma "superfície" associa uma zona retangular a uma saída declarada em Routing - é ela que um cue de vídeo/imagem escolhe como destino (capítulo 8). Separador "Geometria":

Nome, saída de vídeo de destino, padrão de calibração próprio desta superfície, resolução (com botão para retomar a da saída) e opção "superfície multiscreen" para se estender por várias saídas.

Separador "Warp", para corrigir a deformação de uma projeção (parede não plana, ângulo do projetor):

Malha de deformação (modo Linear ou Bézier), número de linhas/colunas de pontos, deslocação com o rato (clicar e arrastar) ou com o teclado (setas, +Shift para um passo de 10px), ponto central para mover toda a superfície, zoom com a roda.

OSC > Sortant (Patch)

Até 6 patches, cada um com o seu protocolo, o seu banco (consola/software de destino), a sua interface de rede de origem, o seu destino e uma palavra-passe opcional consoante o protocolo. Usados pelos cues OSC (capítulo 10).

OSC > Entrant (Serveur)

Recebe comandos OSC para controlar o JustMakeQ à distância (GO, Stop, Pause, cue seguinte/anterior, ir para um número de cue específico).

PJLink

Até 10 videoprojetores patchados (nome, interface de origem, destino, porta, palavra-passe opcional), usados pelos cues PJLink (capítulo 11). O botão "?" consulta o estado do videoprojetor diretamente a partir deste ecrã.

MIDI

Até 4 portas de saída (para os cues MIDI, capítulo 9) e 4 portas de entrada (atalhos MIDI Learn, consola de mistura), abertas automaticamente no arranque.

Capítulo 3

Atalhos de teclado

Preferências > Atalhos de teclado permite personalizar cada atalho e oferece ainda um "MIDI Learn" para controlar o transporte a partir de um controlador MIDI físico (pedaleira, superfície de controlo...).

Atalhos de teclado por omissão, e atalhos MIDI Learn logo abaixo (um clique em "MIDI Learn" e depois uma mensagem CC ou Note associa o controlo).

"Repor as predefinições" restaura estes valores originais com um clique se uma personalização causar problemas.

Capítulo 4

A interface

A janela principal divide-se em três zonas:

De cima para baixo: barra de transporte, barra de adição de cue, e depois as três zonas (Média ativos, cue-list, inspetor).

• Barra de transporte (no topo): GO, Stop All, Pause, Pause All, navegação anterior/seguinte, Set Head, e depois os botões Inspector, Preferências, Console (mistura) e Preview (monitor de pré-visualização).
• Barra "+ Cue": um botão por tipo de cue (ver capítulo 5) e um cadeado para bloquear o arrastar e largar da cue-list (evita a reordenação acidental durante o espetáculo, sem impedir a adição de novos ficheiros).
• Média ativos (canto superior esquerdo): lista ao vivo do que está realmente a ser reproduzido, independentemente da posição do cursor na cue-list.
• Cue-list (canto inferior esquerdo): a sequência do espetáculo. Colunas: # (número), Type, Name, Pre/Dur/Post (tempos), ciclo, marcador, Notes. O triângulo laranja indica o cursor de reprodução (playhead) - o próximo cue que arrancará com o GO.
• Inspetor (à direita): definições do cue selecionado, em dois separadores - "Identidade" (nome, número, cor, tempos, auto-follow/auto-continue, comum a todos os tipos) e "Definições" (específicas do tipo de cue, ver capítulos seguintes).

O menu "☰ Ficheiro" dá acesso a Novo projeto, Abrir, Guardar, Criar um bundle (reúne o projeto e os seus média numa única pasta portátil) e Sessão coworking... (capítulo 16). O menu "?" abre a ajuda, os registos de diagnóstico e a gestão de licença.

Capítulo 5

Os tipos de cues

O JustMakeQ oferece 17 tipos de cues, cada um com a sua própria cor na cue-list para os identificar num relance:

De cima para baixo: Audio, Vídeo, Imagem, MIDI, OSC, PJLink, HTTP, Fade, Group - cada um com a sua cor própria.

• Audio: reprodução de um ficheiro de som, com encaminhamento por canal (capítulo 7).
• Vídeo / Imagem: apresentação numa superfície de projeção, com geometria e efeitos (capítulo 8).
• Stream: apresentação de um fluxo de vídeo de rede ao vivo numa superfície de projeção (capítulo 13).
• MIDI: envio de uma ou várias mensagens MIDI (capítulo 9).
• OSC: envio de um comando OSC, através de um banco pré-configurado ou manualmente (capítulo 10).
• PJLink: controlo de um videoprojetor em rede (capítulo 11).
• HTTP: pedido web para um serviço de terceiros, com modelos prontos a usar (capítulo 12).
• VISCA / ONVIF: controlo pan/tilt/zoom de uma câmara motorizada (capítulo 14).
• Fade: faz variar progressivamente o volume, a opacidade, a posição ou a velocidade de outro cue já lançado.
• Play / Pause: dispara ou coloca em pausa outro cue específico, sem avançar o cursor de reprodução principal.
• Stop: para um cue específico (ou tudo, se nenhum alvo for escolhido).
• Wait: simples pausa cronometrada na sequência.
• GoTo: move o cursor de reprodução para outro cue da lista (ciclos, ramificações).
• Group: agrupa vários cues, reproduzidos em sequência ("Playlist") ou todos ao mesmo tempo ("Simultâneo") - ver capítulo 6.
• Sep (separador): simples marca visual ou de capítulo na cue-list, sem efeito na reprodução; o GO salta-a automaticamente.

Capítulo 6

Conduzir um espetáculo

O cursor de reprodução (playhead, triângulo laranja) avança um cue a cada GO. Cada cue pode ter um tempo de pré-espera (antes de arrancar) e de pós-espera. Duas caixas no separador Identidade controlam o encadeamento automático:

• Auto-follow: o cue seguinte arranca de imediato, sem esperar que o atual termine.
• Auto-continue: o cue seguinte arranca automaticamente após o pós-espera, sem novo toque em GO.

Um cue desarmado (caixa "Armado" desmarcada) segue os mesmos atrasos de um cue normal mas nunca reproduz o seu média - útil para ensaios sem disparar um média (vídeo, som) ainda não pronto, ou para desativar temporariamente um cue sem o eliminar. O seu nome aparece riscado na cue-list.

Grupos: Playlist ou Simultâneo

Um cue Group agrupa vários cues filhos (arrastados para dentro, ou selecionados e depois "Agrupar" através do clique direito). O modo escolhe-se no separador Definições:

O modo de grupo escolhe-se aqui: Playlist (sequencial) ou Simultâneo.

• Playlist (sequencial): os cues filhos encadeiam-se um após o outro, respeitando cada um o seu pré/pós-espera.
• Simultâneo: todos os cues filhos arrancam ao mesmo tempo.

O grupo mostra a sua cor na cue-list consoante o modo, e expande/recolhe com as teclas "<"/">" depois de selecionado.

Capítulo 7

Cue de áudio

O separador Definições de um cue de áudio permite escolher o ficheiro, definir um ponto de início/fim (para reproduzir apenas um excerto), um ciclo, uma velocidade de reprodução e o encaminhamento para as saídas físicas.

Ficheiro, Início/Fim, Loop, Velocidade, e depois o mixer por canal (Master + canais nomeados em Preferências > Audio).

• Velocidade: de 0,25x a 4x, altera a altura ao mesmo tempo (como uma fita de velocidade variável) - sem correção de tom, deliberadamente simples.
• Mixer / Routing: um fader por canal de saída configurado (nomeados em Preferências > Audio > Routing), mais o Master. "Colar as definições da consola" retoma os níveis ajustados ao vivo na Consola de saída (capítulo 9).
• Efeitos de áudio (por baixo do mixer): equalizador de graves/agudos, compressor/limitador, equalizador de 16 bandas (interface gráfica dedicada), reverb (algorítmico, sem convolução) e delay - apenas um efeito ativo de cada vez por cue.

Um cue Fade que vise este cue pode fazer variar progressivamente o volume ou a velocidade já em curso.

Capítulo 8

Cues de vídeo e imagem

Antes de lançar um cue de vídeo ou imagem é necessária pelo menos uma "superfície" de projeção definida em Preferências > Vídeo > Surfaces (capítulo 2), ela própria associada a uma saída física (ecrã) declarada no separador Routing.

Assim que houver uma superfície disponível, o cue de vídeo/imagem oferece:

Ficheiro, superfície de destino e depois Geometria (ecrã inteiro, opacidade, escala, posição, rotação 3D X/Y/Z).

• Geometria: escala, posição, rotação 3D, opacidade - todas animáveis progressivamente por um cue Fade.
• Warp (no editor de superfície, Preferências > Vídeo > Surfaces, capítulo 2): deformação por malha, para corrigir uma projeção sobre um suporte não plano ou um ângulo de projetor.
• Efeitos (comum a vídeo/imagem, por baixo da Geometria): saturação, contraste, luminosidade, preto e branco, sépia.
• Velocidade de reprodução (apenas Vídeo): de 0,25x a 4x, a imagem e o som incorporado mantêm-se sincronizados.

Um cue de imagem partilha a mesma Geometria e os mesmos Efeitos de um cue de vídeo (aqui com Saturação selecionada).

O botão "Preview" da barra de transporte abre uma pré-visualização composta por todos os média atualmente ativos na saída escolhida, sem disparar seja o que for - prático para verificar um enquadramento antes do espetáculo.

Capítulo 9

Cue MIDI e consola de mistura

Um cue MIDI envia uma ou várias mensagens numa porta de saída configurada:

Porta de saída e depois uma lista de mensagens (Note On/Off, Control Change, SysEx, NRPN...), adicionadas ou removidas livremente.

As portas declaram-se em Preferências > MIDI (até 4 saídas e 4 entradas):

As portas de entrada recebem os comandos MIDI (atalhos MIDI Learn, consola de mistura) e abrem automaticamente no arranque.

Consola de saída

O botão "Console" da barra de transporte abre uma consola de mistura: Master + 10 canais de saída, com VU-metros e atribuição MIDI Learn por fader (para controlar cada canal a partir de um controlador físico).

"Copiar as definições" transporta estes níveis para o mixer de um cue de áudio selecionado; "Repor tudo a 0 dB" devolve todos os faders ao seu valor neutro.

Capítulo 10

Cue OSC

Um cue OSC envia um comando a um software ou consola de terceiros. Dois modos no separador Definições:

Modo "Manual": host/porta/endereço OSC introduzidos diretamente, com argumentos (Args) cujo tipo - número, booleano ou texto - é detetado automaticamente.

• Patch (banco pré-configurado): seleciona um patch declarado em Preferências > OSC > Saída, depois escolhe um comando numa lista já adaptada ao produto visado (ETC Eos, QLab, Midas/Behringer, grandMA3, Resolume, OBS...).
• Manual (host / endereço direto): para uma necessidade não coberta por um banco, com host/porta/endereço/argumentos introduzidos à mão.

Os patches de saída e o servidor de escuta de entrada configuram-se em Preferências > OSC:

Até 6 patches de saída, cada um com o seu protocolo, o seu banco, a sua interface de rede de origem, o seu destino e uma palavra-passe opcional consoante o protocolo.

Portas por omissão do JustMakeQ: 53025 (patch genérico) e 53026 (servidor de entrada local), deliberadamente distintas das portas por omissão do QLab.

Capítulo 11

Cue PJLink

O PJLink é um protocolo de rede padrão para controlar videoprojetores (ligar, desligar, seleção de entrada, corte de imagem...). Os videoprojetores são patchados uma vez em Preferências > PJLink (10 posições):

Nome, interface de rede de origem, endereço IP de destino, porta e palavra-passe opcional para cada videoprojetor. O botão "?" no fim da linha consulta diretamente o videoprojetor (nome, fabricante, modelo, alimentação, entrada ativa, shutter, lâmpada, erros); a data da última consulta permanece visível na sua coluna.

Um cue PJLink escolhe depois simplesmente um videoprojetor patchado e um comando:

O cue é renomeado automaticamente para refletir o videoprojetor e o comando escolhidos.

Capítulo 12

Cue HTTP

O cue HTTP envia um pedido web (GET/POST/PUT/PATCH/DELETE) para um serviço de terceiros - útil para controlar praticamente qualquer dispositivo ou software que exponha uma API web (iluminação ligada em rede, notificações, domótica...).

A cascata "Produto" e depois "Ação" oferece modelos prontos a usar; método, URL, cabeçalhos e corpo do pedido continuam livremente editáveis.

Existem modelos pré-preenchidos para cerca de quinze produtos comuns (vMix, WLED, Bitfocus Companion, Philips Hue, Shelly, Home Assistant, Discord, Pushover, ntfy, câmaras PTZ compatíveis com PTZOptics...), para não ser preciso redigir cada pedido. O campo "Última resposta" mostra ao vivo a resposta do servidor, útil para confirmar que um pedido funciona antes do espetáculo.

A opção "Tentar novamente após" reenvia o pedido uma única vez, decorrido o atraso escolhido, se o primeiro envio falhar (falha de rede pontual) - o cue passa a erro apenas se ambas as tentativas falharem.

Capítulo 13

Cue de fluxo ao vivo (Stream)

O cue Stream apresenta um fluxo de vídeo de rede ao vivo numa superfície de projeção - câmara IP, codificador ou misturador de vídeo que exponha um fluxo padrão. Partilha a mesma geometria (posição, escala, rotação), os mesmos efeitos de vídeo e a mesma mistura de áudio (encaminhamento por canal, efeitos) do cue de vídeo clássico (capítulo 8); só muda a fonte.

Protocolos reconhecidos, detetados automaticamente a partir do prefixo do URL introduzido: rtsp://, rtsps://, rtmp://, rtmps://, srt://, rist://, udp://, rtp://, tcp://, bem como http:///https:// para um fluxo HLS (.m3u8) ou DASH (.mpd).

Capítulo 14

Cues VISCA e ONVIF (câmaras PTZ)

Dois cues dedicados permitem controlar uma câmara motorizada pan/tilt/zoom (PTZ) diretamente a partir de um cue, sem software de terceiros: deslocação, zoom, chamada e gravação de predefinições ("presets").

VISCA-over-IP

Protocolo binário padrão, adotado pela maioria das câmaras PTZ profissionais/broadcast (Sony e compatíveis). Cada câmara é patchada uma vez em Preferências > VISCA (destino, porta - 52381 por omissão -, endereço no barramento VISCA de 1 a 7); depois, cada cue VISCA escolhe uma câmara patchada e um comando (pan/tilt nas 4 direções + paragem, zoom aproximar/afastar/parar, posição home, chamar ou gravar uma predefinição de 0 a 127).

ONVIF

Norma aberta baseada em SOAP/HTTP, comum nas câmaras IP de videovigilância e nalguns modelos broadcast. Cada câmara é patchada em Preferências > ONVIF (destino, porta, utilizador/palavra-passe, perfil de média e caminho do serviço - a verificar caso a caso consoante o modelo, pois o valor por omissão não serve a todas as marcas). Comandos disponíveis: deslocação contínua (velocidades pan/tilt/zoom ajustáveis), paragem, posição home, chamar/gravar uma predefinição (identificada por um nome livre, e não por um simples número como em VISCA).

Capítulo 15

Controlo por IA (MCP)

O JustMakeQ integra um servidor MCP (Model Context Protocol) que permite a um assistente de IA compatível (Claude Code, Claude Desktop, Codex...) controlar uma sessão aberta: listar, criar, modificar ou reordenar cues, disparar GO/Stop/Pause.

Desativado por omissão. A porta de escuta (53020) e a interface de rede (localhost por omissão) definem-se aqui, bem como o token de acesso exigido para qualquer ligação.

Assim que o servidor estiver ativado, o separador oferece exemplos de configuração prontos a copiar para os principais clientes de IA (comando CLI, ficheiro .mcp.json, config.toml).

Capítulo 16

Coworking

O coworking permite que vários operadores conduzam a mesma sequência ao mesmo tempo a partir de postos diferentes: um anfitrião reproduz efetivamente os média, os clientes ligados veem o estado ao vivo (cue-list, estados, playhead) e podem, consoante o seu nível de permissão, editar a sequência ou disparar comandos de transporte.

Acessível através do menu Ficheiro > "Sessão coworking...": iniciar uma sessão como anfitrião, ou juntar-se a uma sessão descoberta automaticamente na rede local. O anfitrião aprova manualmente cada nova ligação e pode ajustar a qualquer momento o nível de cada cliente (apenas leitura, edição ou controlo completo) na caixa de diálogo "Colaboradores".

Capítulo 17

Resolução de problemas

Ver registos

O menu "?" > "Ver os registos..." abre diretamente a pasta que contém os ficheiros de log, com data e hora a cada arranque. Em caso de falha, essa pasta contém uma exceção Python completa ou - para uma falha de nível mais baixo (nativa) - um ficheiro separado *_fault.log com a pilha de todos os threads no momento da falha. Anexar estes ficheiros a qualquer pedido de suporte acelera bastante o diagnóstico.

Problemas frequentes

• Um cue de vídeo/imagem não mostra nada: verificar que está mesmo selecionada uma superfície nas suas Definições e que esta está associada a uma saída física real em Preferências > Vídeo > Routing.
• Sem som: verificar a interface escolhida em Preferências > Audio > Routing e o encaminhamento por canal no separador Definições do cue.
• Um comando OSC/HTTP/PJLink não sai: o campo "Última resposta" (HTTP) ou os indicadores de estado do servidor no canto inferior direito da janela principal ajudam a confirmar que existe realmente uma ligação de rede.
• Licença: o menu "?" > "Gerir a licença" mostra o estado detalhado; em caso de erro de rede durante a ativação, a mensagem indica agora a causa (relógio do sistema, firewall, DNS, proxy).

Para qualquer questão não abordada aqui, a página Suporte permite contactar diretamente a equipa.