Capítulo 1

Primeros pasos

JustMakeQ es un software de control de espectáculo multimedia: reproduce en orden una lista de "cues" (audio, vídeo, imagen, MIDI, OSC...) a lo largo de un espectáculo, disparadas una a una con la tecla GO.

Instalar y ejecutar JustMakeQ

Descarga el instalador correspondiente a tu sistema desde tu espacio de descarga y ejecútalo. En el primer arranque aparece la pantalla de bienvenida:

La pantalla de bienvenida: crear un proyecto nuevo, abrir uno existente o recuperar un proyecto reciente.

El estado de la licencia aparece bajo el logotipo ("Licencia activada" en verde). Si aún no es el caso, el botón "Gestionar mi licencia" abre el asistente de activación: consulta el archivo .jmqa recibido por correo al crear tu cuenta.

Crear un primer proyecto

Haz clic en "Nuevo Q" para iniciar un proyecto vacío. Se abre la ventana principal, con una cue-list todavía vacía:

La ventana principal: barra de transporte (GO/Stop/Pause) arriba, botones para añadir cues justo debajo, cue-list a la izquierda, inspector a la derecha.

Para añadir un cue, haz clic en su tipo en la barra "+ Cue" (Audio, Vídeo, Imagen, MIDI, OSC, PJLink, HTTP, Fade, Play, Pause, Stop, Wait, Group, Sep). Aparece de inmediato en la cue-list:

Se acaba de añadir un cue de audio: aparece en rojo/naranja mientras no haya ningún archivo asociado.

Haz clic en el cue de la lista para abrirlo en el inspector (a la derecha): ahí se ajustan todos sus parámetros, empezando por el archivo que se va a reproducir, en la pestaña "Ajustes".

Un cue seleccionado: el inspector muestra su identidad (nombre, número, color) y su temporización (pre-wait, post-wait, auto-follow/auto-continue).

Lanzar el espectáculo

• Espacio o el botón GO: dispara el cue situado bajo el cursor de reproducción (el triángulo naranja de la cue-list) y avanza el cursor al siguiente.
• Esc o el botón Stop All: detiene todo lo que se está reproduciendo.
• P o el botón Pause: pausa el cue seleccionado; Pause All pausa todo (sin atajo por defecto).
• H o el botón Set Head: mueve el cursor de reproducción al cue seleccionado sin dispararlo.
• ↓ / ↑: mueven el cursor de reproducción al cue siguiente/anterior sin dispararlo.

Estos son los atajos por defecto: se personalizan en Preferencias > Atajos de teclado.

Cada cue puede tener un tiempo de pre-espera (antes de arrancar) y de post-espera (antes de que el cue siguiente se encadene automáticamente, si "Auto-continue" está marcado). "Auto-follow" dispara el cue siguiente de inmediato, sin esperar a que termine el actual.

Capítulo 2

Preferencias

El botón "Preferencias" de la barra de herramientas abre un diálogo con pestañas que centraliza todos los ajustes que no dependen de un proyecto concreto (hardware, red, atajos). El detalle de cada pestaña figura más abajo; los Atajos de teclado tienen su propio capítulo (3), igual que el control por IA (13).

General

Tema, aceleración GPU para el vídeo, protección GO (retardo mínimo antidoble pulsación), comportamiento de Stop All (parada inmediata o fundido), opción de clic en la cue-list, exportación/importación de ajustes.

"Exportar los ajustes..." / "Importar los ajustes..." (abajo) guardan o transfieren a un archivo todo lo independiente del hardware (tema, idioma, patches OSC, servidores, atajos): práctico para duplicar la configuración en otra máquina sin rehacer todos los ajustes a mano. Las pantallas, tarjetas de sonido y superficies de vídeo propias de cada instalación nunca se incluyen.

Audio > Routing

Cada salida física (tarjeta de sonido) se declara una vez: nombre, interfaz, número de canales.

Audio > Patch

Cada canal patch (usado en el mixer de un cue de audio, capítulo 7) se nombra libremente aquí y se enruta a un canal real de una salida declarada en Routing.

Vídeo > Routing

Cada salida física (pantalla) se nombra una vez; se puede lanzar directamente una carta de ajuste (rejilla, damero...) para comprobar el encuadre en la pantalla correcta.

Vídeo > Surfaces

Una "superficie" asocia una zona rectangular a una salida declarada en Routing: es la que un cue de vídeo/imagen elige como destino (capítulo 8). Pestaña "Geometría":

Nombre, salida de vídeo de destino, carta de ajuste propia de esta superficie, resolución (con botón para tomar la de la salida) y opción "superficie multiscreen" para extenderse por varias salidas.

Pestaña "Warp", para corregir la deformación de una proyección (pared no plana, ángulo del proyector):

Malla de deformación (modo Lineal o Bézier), número de filas/columnas de puntos, desplazamiento con el ratón (clic y arrastrar) o con el teclado (flechas, +Shift para un paso de 10px), punto central para mover toda la superficie, zoom con la rueda.

OSC > Sortant (Patch)

Hasta 6 patches, cada uno con su protocolo, su banco (consola/software de destino), su interfaz de red de origen, su destino y una contraseña opcional según el protocolo. Los usan los cues OSC (capítulo 10).

OSC > Entrant (Serveur)

Recibe comandos OSC para controlar JustMakeQ a distancia (GO, Stop, Pause, cue siguiente/anterior, ir a un número de cue concreto).

PJLink

Hasta 10 videoproyectores patcheados (nombre, interfaz de origen, destino, puerto, contraseña opcional), usados por los cues PJLink (capítulo 11). El botón "?" consulta el estado del videoproyector directamente desde esta pantalla.

MIDI

Hasta 4 puertos de salida (para los cues MIDI, capítulo 9) y 4 puertos de entrada (atajos MIDI Learn, consola de mezcla), abiertos automáticamente al arrancar.

Capítulo 3

Atajos de teclado

Preferencias > Atajos de teclado permite personalizar cada atajo y ofrece además un "MIDI Learn" para controlar el transporte desde un controlador MIDI físico (pedalera, superficie de control...).

Atajos de teclado por defecto, y atajos MIDI Learn justo debajo (un clic en "MIDI Learn" y luego un mensaje CC o Note asocia el control).

"Restablecer los valores por defecto" restaura estos valores originales con un clic si una personalización causa problemas.

Capítulo 4

La interfaz

La ventana principal se divide en tres zonas:

De arriba abajo: barra de transporte, barra de añadir cue, y luego las tres zonas (Medios activos, cue-list, inspector).

• Barra de transporte (arriba): GO, Stop All, Pause, Pause All, navegación anterior/siguiente, Set Head, y luego los botones Inspector, Preferencias, Console (mezcla) y Preview (monitor de previsualización).
• Barra "+ Cue": un botón por tipo de cue (ver capítulo 5) y un candado para bloquear el arrastrar y soltar de la cue-list (evita el reordenamiento accidental durante el espectáculo, sin impedir añadir nuevos archivos).
• Medios activos (arriba a la izquierda): lista en directo de lo que se está reproduciendo realmente, con independencia de la posición del cursor en la cue-list.
• Cue-list (abajo a la izquierda): la secuencia del espectáculo. Columnas: # (número), Type, Name, Pre/Dur/Post (tiempos), bucle, marcador, Notes. El triángulo naranja indica el cursor de reproducción (playhead): el próximo cue que se disparará con GO.
• Inspector (derecha): ajustes del cue seleccionado, en dos pestañas: "Identidad" (nombre, número, color, temporización, auto-follow/auto-continue, común a todos los tipos) y "Ajustes" (específico del tipo de cue, ver capítulos siguientes).

El menú "☰ Archivo" da acceso a Nuevo proyecto, Abrir, Guardar, Crear un bundle (agrupa el proyecto y sus medios en una sola carpeta portátil) y Sesión coworking... (capítulo 16). El menú "?" abre la ayuda, los registros de diagnóstico y la gestión de licencia.

Capítulo 5

Los tipos de cues

JustMakeQ ofrece 17 tipos de cues, cada uno con su propio color en la cue-list para localizarlos de un vistazo:

De arriba abajo: Audio, Vídeo, Imagen, MIDI, OSC, PJLink, HTTP, Fade, Group, cada uno con su color propio.

• Audio: reproducción de un archivo de sonido, con enrutado por canal (capítulo 7).
• Vídeo / Imagen: visualización en una superficie de proyección, con geometría y efectos (capítulo 8).
• Stream: visualización de un flujo de vídeo de red en directo sobre una superficie de proyección (capítulo 13).
• MIDI: envío de uno o varios mensajes MIDI (capítulo 9).
• OSC: envío de un comando OSC, mediante un banco preconfigurado o de forma manual (capítulo 10).
• PJLink: control de un videoproyector en red (capítulo 11).
• HTTP: petición web a un servicio de terceros, con plantillas listas para usar (capítulo 12).
• VISCA / ONVIF: control pan/tilt/zoom de una cámara motorizada (capítulo 14).
• Fade: hace variar progresivamente el volumen, la opacidad, la posición o la velocidad de otro cue ya lanzado.
• Play / Pause: dispara o pausa otro cue concreto, sin avanzar el cursor de reproducción principal.
• Stop: detiene un cue concreto (o todo, si no se elige ningún destino).
• Wait: simple pausa cronometrada en la secuencia.
• GoTo: mueve el cursor de reproducción hacia otro cue de la lista (bucles, ramificaciones).
• Group: agrupa varios cues, reproducidos en secuencia ("Playlist") o todos a la vez ("Simultáneo") - ver capítulo 6.
• Sep (separador): simple marca visual o de capítulo en la cue-list, sin efecto sobre la reproducción; el GO lo salta automáticamente.

Capítulo 6

Dirigir un espectáculo

El cursor de reproducción (playhead, triángulo naranja) avanza un cue con cada GO. Cada cue puede tener un tiempo de pre-espera (antes de arrancar) y de post-espera. Dos casillas de la pestaña Identidad controlan el encadenamiento automático:

• Auto-follow: el cue siguiente arranca de inmediato, sin esperar a que termine el actual.
• Auto-continue: el cue siguiente arranca automáticamente tras el post-wait, sin pulsar GO de nuevo.

Un cue desarmado (casilla "Armado" desmarcada) respeta los mismos retardos que un cue normal pero nunca reproduce su medio: útil para ensayar sin disparar un medio (vídeo, sonido) que aún no está listo, o para desactivar temporalmente un cue sin borrarlo. Su nombre aparece tachado en la cue-list.

Grupos: Playlist o Simultáneo

Un cue Group agrupa varios cues hijos (arrastrados dentro, o seleccionados y luego "Agrupar" con el clic derecho). El modo se elige en la pestaña Ajustes:

El modo de grupo se elige aquí: Playlist (secuencial) o Simultáneo.

• Playlist (secuencial): los cues hijos se encadenan uno tras otro, respetando cada uno su propio pre/post-wait.
• Simultáneo: todos los cues hijos arrancan al mismo tiempo.

El grupo muestra su color en la cue-list según su modo, y se despliega/repliega con las teclas "<"/">" una vez seleccionado.

Capítulo 7

Cue de audio

La pestaña Ajustes de un cue de audio permite elegir el archivo, definir un punto de inicio/fin (para reproducir solo un fragmento), un bucle, una velocidad de reproducción y el enrutado hacia las salidas físicas.

Archivo, Inicio/Fin, Loop, Velocidad, y luego el mixer por canal (Master + canales nombrados en Preferencias > Audio).

• Velocidad: de 0,25x a 4x, cambia el tono al mismo tiempo (como una cinta de velocidad variable): sin corrección de tono, deliberadamente simple.
• Mixer / Routing: un fader por canal de salida configurado (nombrados en Preferencias > Audio > Routing), más el Master. "Pegar los ajustes de consola" recupera los niveles ajustados en directo en la Consola de salida (capítulo 9).
• Efectos de audio (bajo el mixer): ecualizador de graves/agudos, compresor/limitador, ecualizador de 16 bandas (interfaz gráfica dedicada), reverb (algorítmica, sin convolución) y delay: un solo efecto activo a la vez por cue.

Un cue Fade que apunte a este cue puede hacer variar progresivamente el volumen o la velocidad ya en curso.

Capítulo 8

Cues de vídeo e imagen

Antes de lanzar un cue de vídeo o imagen hace falta al menos una "superficie" de proyección definida en Preferencias > Vídeo > Surfaces (capítulo 2), asociada a su vez a una salida física (pantalla) declarada en la pestaña Routing.

Una vez disponible una superficie, el cue de vídeo/imagen ofrece:

Archivo, superficie de destino y luego Geometría (pantalla completa, opacidad, escala, posición, rotación 3D X/Y/Z).

• Geometría: escala, posición, rotación 3D, opacidad: animables progresivamente mediante un cue Fade.
• Warp (en el editor de superficie, Preferencias > Vídeo > Surfaces, capítulo 2): deformación por malla, para corregir una proyección sobre un soporte no plano o un ángulo de proyector.
• Efectos (común a vídeo/imagen, bajo la Geometría): saturación, contraste, brillo, blanco y negro, sepia.
• Velocidad de reproducción (solo vídeo): de 0,25x a 4x, la imagen y el sonido incrustado permanecen sincronizados.

Un cue de imagen comparte la misma Geometría y los mismos Efectos que un cue de vídeo (aquí con Saturación seleccionada).

El botón "Preview" de la barra de transporte abre una previsualización compuesta por todos los medios actualmente activos en la salida elegida, sin disparar nada: práctico para comprobar un encuadre antes del espectáculo.

Capítulo 9

Cue MIDI y consola de mezcla

Un cue MIDI envía uno o varios mensajes por un puerto de salida configurado:

Puerto de salida y luego una lista de mensajes (Note On/Off, Control Change, SysEx, NRPN...), que se añaden o eliminan libremente.

Los puertos se declaran en Preferencias > MIDI (hasta 4 salidas y 4 entradas):

Los puertos de entrada reciben los comandos MIDI (atajos MIDI Learn, consola de mezcla) y se abren automáticamente al arrancar.

Consola de salida

El botón "Console" de la barra de transporte abre una consola de mezcla: Master + 10 canales de salida, con vúmetros y asignación MIDI Learn por fader (para controlar cada canal desde un controlador físico).

"Copiar los ajustes" traslada estos niveles al mixer de un cue de audio seleccionado; "Reset todo a 0 dB" devuelve todos los faders a su valor neutro.

Capítulo 10

Cue OSC

Un cue OSC envía un comando a un software o una consola de terceros. Dos modos en la pestaña Ajustes:

Modo "Manual": host/puerto/dirección OSC introducidos directamente, con argumentos (Args) cuyo tipo (número, booleano o texto) se detecta automáticamente.

• Patch (banco preconfigurado): selecciona un patch declarado en Preferencias > OSC > Saliente y luego elige un comando de una lista ya adaptada al producto de destino (ETC Eos, QLab, Midas/Behringer, grandMA3, Resolume, OBS...).
• Manual (host / dirección directa): para una necesidad no cubierta por un banco, con host/puerto/dirección/argumentos introducidos a mano.

Los patches salientes y el servidor de escucha entrante se configuran en Preferencias > OSC:

Hasta 6 patches salientes, cada uno con su protocolo, su banco, su interfaz de red de origen, su destino y una contraseña opcional según el protocolo.

Puertos por defecto de JustMakeQ: 53025 (patch genérico) y 53026 (servidor entrante local), deliberadamente distintos de los puertos por defecto de QLab.

Capítulo 11

Cue PJLink

PJLink es un protocolo de red estándar para controlar videoproyectores (encendido, apagado, selección de entrada, corte de imagen...). Los videoproyectores se patchean una vez en Preferencias > PJLink (10 ranuras):

Nombre, interfaz de red de origen, dirección IP de destino, puerto y contraseña opcional para cada videoproyector. El botón "?" al final de la fila consulta directamente el videoproyector (nombre, fabricante, modelo, alimentación, entrada activa, shutter, lámpara, errores); la fecha de la última consulta permanece visible en su columna.

Un cue PJLink solo tiene que elegir después un videoproyector patcheado y un comando:

El cue se renombra automáticamente para reflejar el videoproyector y el comando elegidos.

Capítulo 12

Cue HTTP

El cue HTTP envía una petición web (GET/POST/PUT/PATCH/DELETE) a un servicio de terceros: útil para controlar prácticamente cualquier dispositivo o software que exponga una API web (iluminación conectada, notificaciones, domótica...).

La cascada "Producto" y luego "Acción" ofrece plantillas listas para usar; método, URL, cabeceras y cuerpo de la petición siguen siendo libremente modificables.

Existen plantillas prerrellenadas para una quincena de productos habituales (vMix, WLED, Bitfocus Companion, Philips Hue, Shelly, Home Assistant, Discord, Pushover, ntfy, cámaras PTZ compatibles con PTZOptics...), para no tener que redactar cada petición uno mismo. El campo "Última respuesta" muestra en directo la respuesta del servidor, útil para comprobar que una petición funciona antes del espectáculo.

La opción "Reintentar automáticamente después de" reenvía la petición una sola vez tras el retardo elegido si el primer envío falla (fallo de red puntual): el cue pasa a error únicamente si fallan los dos intentos.

Capítulo 13

Cue de flujo en directo (Stream)

El cue Stream muestra un flujo de vídeo de red en directo sobre una superficie de proyección: cámara IP, codificador o mezclador de vídeo que exponga un flujo estándar. Comparte la misma geometría (posición, escala, rotación), los mismos efectos de vídeo y la misma mezcla de audio (enrutado por canal, efectos) que el cue de vídeo clásico (capítulo 8); solo cambia la fuente.

Protocolos reconocidos, detectados automáticamente a partir del prefijo de la URL introducida: rtsp://, rtsps://, rtmp://, rtmps://, srt://, rist://, udp://, rtp://, tcp://, así como http:///https:// para un flujo HLS (.m3u8) o DASH (.mpd).

Capítulo 14

Cues VISCA y ONVIF (cámaras PTZ)

Dos cues dedicados permiten controlar una cámara motorizada pan/tilt/zoom (PTZ) directamente desde un cue, sin software de terceros: desplazamiento, zoom, recuperación y grabación de preajustes ("presets").

VISCA-over-IP

Protocolo binario estándar, adoptado por la mayoría de las cámaras PTZ profesionales/broadcast (Sony y compatibles). Cada cámara se patchea una vez en Preferencias > VISCA (destino, puerto - 52381 por defecto -, dirección en el bus VISCA de 1 a 7); después, cada cue VISCA elige una cámara patcheada y un comando (pan/tilt en las 4 direcciones + parada, zoom acercar/alejar/parar, posición home, recuperar o grabar un preset de 0 a 127).

ONVIF

Estándar abierto basado en SOAP/HTTP, extendido en las cámaras IP de videovigilancia y algunos modelos broadcast. Cada cámara se patchea en Preferencias > ONVIF (destino, puerto, usuario/contraseña, perfil de medios y ruta del servicio: a comprobar caso por caso según el modelo, ya que el valor por defecto no sirve para todas las marcas). Comandos disponibles: desplazamiento continuo (velocidades pan/tilt/zoom ajustables), parada, posición home, recuperar/grabar un preset (identificado por un nombre libre, no por un simple número como en VISCA).

Capítulo 15

Control por IA (MCP)

JustMakeQ incorpora un servidor MCP (Model Context Protocol) que permite a un asistente de IA compatible (Claude Code, Claude Desktop, Codex...) controlar una sesión abierta: listar, crear, modificar o reordenar cues, disparar GO/Stop/Pause.

Desactivado por defecto. El puerto de escucha (53020) y la interfaz de red (localhost por defecto) se configuran aquí, así como el token de acceso necesario para cualquier conexión.

Una vez activado el servidor, la pestaña ofrece ejemplos de configuración listos para copiar para los principales clientes de IA (comando CLI, archivo .mcp.json, config.toml).

Capítulo 16

Coworking

El coworking permite que varios técnicos manejen la misma secuencia al mismo tiempo desde puestos distintos: un anfitrión reproduce realmente los medios, los clientes conectados ven el estado en directo (cue-list, estados, playhead) y pueden, según su nivel de permiso, editar la secuencia o disparar comandos de transporte.

Accesible desde el menú Archivo > "Sesión coworking...": iniciar una sesión como anfitrión o unirse a una sesión descubierta automáticamente en la red local. El anfitrión aprueba manualmente cada nueva conexión y puede ajustar en cualquier momento el nivel de cada cliente (solo lectura, edición o control completo) desde el diálogo "Colaboradores".

Capítulo 17

Resolución de problemas

Ver registros

El menú "?" > "Ver los registros..." abre directamente la carpeta que contiene los archivos de log, con marca de tiempo en cada arranque. En caso de fallo, esa carpeta contiene o bien una excepción Python completa, o bien - para un fallo de más bajo nivel (nativo) - un archivo aparte *_fault.log con la pila de todos los hilos en el momento del fallo. Adjuntar estos archivos a cualquier solicitud de soporte acelera mucho el diagnóstico.

Problemas frecuentes

• Un cue de vídeo/imagen no muestra nada: comprobar que hay una superficie seleccionada en sus Ajustes y que está asociada a una salida física real en Preferencias > Vídeo > Routing.
• Sin sonido: comprobar la interfaz elegida en Preferencias > Audio > Routing y el enrutado por canal en la pestaña Ajustes del cue.
• Un comando OSC/HTTP/PJLink no sale: el campo "Última respuesta" (HTTP) o los indicadores de estado del servidor en la parte inferior derecha de la ventana principal ayudan a confirmar que existe realmente una conexión de red.
• Licencia: el menú "?" > "Gestionar la licencia" muestra el estado detallado; en caso de error de red durante la activación, el mensaje indica ahora la causa (reloj del sistema, cortafuegos, DNS, proxy).

Para cualquier duda no cubierta aquí, la página Soporte permite contactar directamente con el equipo.