Capítulo 7 · Manual de usuario de OpenQ

Seguridad y ayuda

7.1Seguridad ante fallos

Un espectáculo tiene que seguir cuando algo sale mal. OpenQ mantiene los problemas lo más pequeños posible y recupera tu trabajo si llega a caerse.

Autoguardado y recuperación

Mientras un espectáculo tiene cambios sin guardar, OpenQ guarda una copia cada pocos segundos. Guardar el espectáculo, o salir con normalidad, borra la copia. Si OpenQ o el ordenador se caen, el siguiente arranque te ofrece la copia:

Ventana Recuperar trabajo sin guardar con dos espectáculos autoguardados, cada uno con botones Recuperar y Descartar, y un botón Más tarde.
Después de un fallo: cada espectáculo con cambios sin guardar, cuándo se autoguardó y a qué archivo pertenece.
  • Recuperar abre la copia con los cambios sin guardar. Guárdala para conservarlos (se guarda en el propio archivo del espectáculo).
  • Descartar borra la copia para siempre.
  • Más tarde cierra la ventana; vuelve a preguntar la próxima vez.

Guardar un espectáculo escribe primero un archivo temporal y lo pone en su lugar cuando ya está a salvo en el disco, así que un fallo o un corte de luz durante el guardado deja intacta la versión anterior.

Cuando algo falla durante una función

Qué pasaQué hace OpenQ
El dispositivo de audio desaparece (desconectado, servidor de audio reiniciado)Sus sonidos se paran y la barra de estado muestra audio perdido · reconectando…. OpenQ intenta abrir el mismo dispositivo cada 2 segundos y sigue en cuanto vuelve. El vídeo y las demás cues siguen funcionando.
Un archivo de medios está dañadoEsa cue termina con un error en Ver → Registro del motor; todas las demás cues siguen sonando.
Un error interno en el motor de cuesTodas las cues se paran a la vez, el cabezal se queda donde estaba y el registro explica qué pasó. El siguiente GO funciona como siempre.
Una cue se inicia a sí misma en un bucle sin tiempo (una cue Iniciar que apunta a sí misma, o dos que se apuntan entre sí)Se retiene y el registro nombra la cue, en lugar de ralentizar todo el espectáculo.
Más de 256 sonidos a la vezLas cues de audio adicionales se rechazan con un error en el registro.

Los autoguardados y los informes de fallos están en la carpeta de ajustes de OpenQ: ~/.config/openq en Linux, ~/Library/Application Support/OpenQ en macOS, %APPDATA%\OpenQ en Windows, en recovery y crash. Un informe de fallo contiene qué salió mal y dónde; adjúntalo, por favor, cuando informes de un problema.

Registro de errores. Cada aviso y error (entradas del registro del motor, fallos de dispositivos, guardados o aperturas fallidos, caídas) también se escribe, con la fecha y la hora en UTC, en logs/openq.log dentro de la misma carpeta, para que puedas revisarlo después de la función. Ayuda → Registro de errores lo abre. Cuando supera los 2 MB, se mueve a openq.old.log la próxima vez que arranca OpenQ.

7.2Solución de problemas

ProblemaPrueba
No hay sonidoMira la barra de estado. Si dice sin audio, elige otro dispositivo en Ajustes → Audio. Comprueba el volumen maestro y el nivel y el enrutado de la cue.
Una cue Micro no suenaComprueba el dispositivo de entrada y los canales en su pestaña I/O; la barra de nivel muestra si llega algo. En macOS y Windows, OpenQ necesita permiso para usar el micrófono.
Los disparadores por código de tiempo no se disparanAbre la ventana Timecode… de la lista y comprueba que recibe código de tiempo a la frecuencia correcta. Las cues solo se disparan mientras el código avanza por su tiempo de disparo.
Una cue Cámara no muestra nadaComprueba el dispositivo en su pestaña Cámara (usa para volver a buscar) y el registro del motor. Otro programa que use la cámara puede bloquearla.
Una cue muestra un icono rojo Su archivo de medios falta o no se puede leer, o se borró su cue de destino. Si el archivo se movió, haz clic en Examinar… en la pestaña Básico de la cue para encontrarlo de nuevo. Tras reconectar una unidad, dale unos dos segundos para que desaparezca.
Un vídeo no apareceAbre la ventana del escenario desde el menú Vídeo. Comprueba el escenario, la opacidad y la capa de la cue, y busca errores del decodificador en Ver → Registro del motor. Una tarjeta gráfica solo puede mostrar imágenes hasta cierto tamaño (a menudo 8192 o 16384 píxeles de ancho). OpenQ reduce imágenes fijas, SVG y texto para que quepan, pero una película mayor se queda fuera: conviértela a un tamaño menor.
La barra de estado dice audio perdido · reconectando…El dispositivo de audio desapareció. Vuelve a conectarlo o reinicia el servicio de audio; OpenQ se reconecta solo. Para usar otro dispositivo, elígelo en Ajustes → Audio.
OpenQ pide recuperar trabajo sin guardarLa última vez no se cerró con normalidad. Ver Seguridad ante fallos.
GO parece no hacer nadaLa cue bajo el cabezal puede estar desarmada, o la segunda pulsación puede haber llegado dentro de la protección contra doble GO.
Un dispositivo remoto no encuentra el principalAsegúrate de que el acceso remoto está activado y de que los dos están en la misma red, y escribe la dirección que aparece en el dispositivo principal.
"Pair this device again" (remoto)El dispositivo se quitó en el principal, o se olvidó su clave. Abre el emparejamiento en el dispositivo principal e introduce el código nuevo.
Algo falla y no sabes por quéAbre Ayuda → Registro de errores: cada aviso, error y caída queda allí con su hora.

7.3Licencia y créditos

OpenQ se distribuye bajo la Apache License 2.0. Este resumen es orientativo; el texto en inglés es el que vale.

PuedesDebes
Usar OpenQ para cualquier cosa, también comercial: hacer funciones, conciertos, giras, eventos e instalaciones de pago, y cobrar por programarlos u operarlos.Conservar el aviso de copyright, LICENSE.md y NOTICE.md en cada copia.
Copiarlo, modificarlo y compartirlo.Indicar en los archivos que modifiques que han cambiado.
Vender copias, versiones modificadas o servicios basados en él.No usar el nombre OpenQ como marca: la licencia no da derecho a ello.
Copyright 2026 Iago Núñez — OpenQ (https://github.com/iagonunez/OpenQ)

Ayuda → Acerca de OpenQ y licencias muestra la versión, la licencia y todos los avisos de terceros. Son las fuentes (Inter, JetBrains Mono y Barlow Condensed bajo la SIL Open Font License; Material Symbols bajo Apache 2.0; las fuentes incluidas en egui) y las bibliotecas Rust de código abierto con las que se construye OpenQ, cada una con su propia licencia. Los mismos textos están en NOTICE.md y THIRD_PARTY_LICENSES.md junto al programa.

Vídeo y FFmpeg

OpenQ reproduce vídeo con las bibliotecas FFmpeg. En Windows y macOS el instalador pone dentro de OpenQ una compilación sin partes GPL, con su licencia en la carpeta Licenses; en Linux OpenQ usa el FFmpeg del sistema. FFmpeg tiene su propia licencia. Si pasas un OpenQ compilado a otras personas, usa un FFmpeg sin partes GPL, o la GPL 3 cubrirá todo el programa. Ver NOTICE.md.

OpenQ · Apache 2.0. Fuentes: Inter, JetBrains Mono, Barlow Condensed (SIL OFL 1.1) y Material Symbols (Apache 2.0).