Solución de problemas

Si experimenta un problema con OpenShot, como un bloqueo, fallo o mensaje de error, existen diversas técnicas que pueden ser útiles para solucionar el problema.

Uso de registros para solucionar un problema

Un registro es un archivo de texto que registra lo que OpenShot está haciendo, junto con advertencias y errores. Estos archivos pueden ayudar al equipo de soporte a entender un problema, incluso cuando no ves un mensaje de error en pantalla.

OpenShot mantiene dos archivos de registro en la carpeta .openshot_qt dentro de tu carpeta personal. En Linux y macOS, esta ubicación se escribe como ~/.openshot_qt/. La carpeta puede estar oculta en tu gestor de archivos.

Los dos archivos de registro
Archivo	Lo que registra
`openshot-qt.log`	Actividad en el editor: iniciar OpenShot, cargar proyectos, cambiar configuraciones y usar la interfaz. Este suele ser el mejor lugar para comenzar al investigar un problema.
`libopenshot.log`	Actividad en el motor de video y audio de OpenShot, la parte que lee los medios y construye las imágenes y sonidos usados en las vistas previas y videos exportados. El registro detallado del motor puede ayudar a investigar problemas de reproducción y exportación.

Estos archivos registran diferentes partes de la misma aplicación. Al reportar un problema, incluye ambos archivos si están disponibles. No necesitas entender cada línea por ti mismo.

Elige qué parte de OpenShot registrar

Abre Editar → Preferencias → Avanzado para encontrar estas dos configuraciones:

Preferencias y opciones correspondientes en la terminal
Preferencia	Argumento correspondiente	Archivo de registro
Registro de depuración de la interfaz de usuario	`--debug-ui`	`openshot-qt.log`
Registro de depuración del motor de video y audio	`--debug-engine`	`libopenshot.log`

Ambas preferencias están desactivadas por defecto, lo que mantiene los mensajes resumen normales. Activar una añade detalles a su archivo de registro inmediatamente. No cambia el otro registro ni añade mensajes a la terminal. Las preferencias permanecen activadas entre lanzamientos hasta que las desactives.

El registro de depuración de la interfaz de usuario es un buen punto de partida para problemas con el inicio, carga de proyectos, configuraciones o la interfaz. El registro de depuración del motor de video y audio añade detalles sobre el procesamiento de video y audio, lo que puede ayudar a investigar problemas de reproducción y exportación. Los registros del motor pueden crecer muy rápido y pueden ralentizar OpenShot. Activa esta configuración poco antes de repetir el problema y luego desactívala.

La preferencia del motor se llamaba anteriormente Modo de depuración (detallado). Su configuración guardada de activado/desactivado se mantiene con el nuevo nombre.

Usa una terminal para un lanzamiento

Una terminal es una ventana donde escribes comandos. Los argumentos correspondientes habilitan el mismo detalle extra que las preferencias, y también lo muestran en la terminal:

openshot-qt --debug-ui

Esto registra detalles de la interfaz para un lanzamiento. Las opciones familiares --debug y la más corta -d significan exactamente lo mismo que --debug-ui. Para detalles del motor de video y audio, usa:

openshot-qt --debug-engine

Para recopilar ambos tipos de detalles juntos:

openshot-qt --debug-ui --debug-engine

Repite los pasos que causan el problema, luego cierra OpenShot y recopila los registros. Estos argumentos no cambian tus preferencias guardadas. Iniciar OpenShot normalmente vuelve a tus configuraciones habituales de registro.

openshot-qt.log inicia un archivo nuevo cuando alcanza aproximadamente 25 MB y mantiene tres copias antiguas. libopenshot.log sigue creciendo a medida que se añaden mensajes. Después de guardar los registros que necesites, puedes eliminar archivos de registro antiguos mientras OpenShot esté cerrado.

Otras opciones de línea de comandos

La mayoría de los usuarios solo necesitan los dos controles anteriores. Las siguientes opciones te permiten elegir cuánta información se registra en los archivos o aparece en la terminal. Aquí, consola significa la salida de la terminal.

Opciones de registro
Opción	Qué hace
`--debug-ui`, `--debug` o `-d`	Habilita el registro de depuración de la interfaz de usuario en su archivo y en la terminal.
`--debug-engine`	Habilita el registro de depuración del motor de video y audio en su archivo y en la terminal.
`--debug-file`	Agrega detalles del editor a `openshot-qt.log` sin añadir detalles en la terminal.
`--debug-console`	Agrega detalles del editor en la terminal sin añadir detalles en el archivo.
`--log-level LEVEL`	Establece el nivel de detalle para ambos registros y su salida en la terminal.
`--log-file-level LEVEL`	Establece el nivel de detalle para ambos archivos de registro, sin modificar la configuración de la terminal.
`--log-console-level LEVEL`	Establece el nivel de detalle en la terminal para el editor y el motor, sin modificar la configuración de archivos.

Reemplace LEVEL por debug para mensajes detallados o info para el resumen normal. warning muestra advertencias y errores; error muestra errores y fallos críticos; critical muestra solo fallos críticos. off detiene los mensajes de registro ordinarios, pero aún pueden escribirse diagnósticos de fallos existentes. También funcionan nombres en mayúsculas como DEBUG.

Por ejemplo, para recopilar mensajes detallados en ambos archivos mientras se mantiene el nivel habitual en la terminal:

openshot-qt --log-file-level debug

Esto también habilita el registro extenso del motor, úselo brevemente. Las opciones antiguas --debug-file y --debug-console aún funcionan aunque no aparezcan en --help.

Variables de entorno

Una variable de entorno es una configuración nombrada que se pasa a un programa al iniciarlo. Son útiles al iniciar OpenShot desde un script o cuando un soporte técnico te pide probar una configuración específica. No es necesario configurarlas para el uso normal.

Configuraciones opcionales de entorno
Variable	Qué controla
`OPENSHOT_LOG_LEVEL`	Detalle en ambos archivos y en la terminal.
`OPENSHOT_LOG_FILE_LEVEL`	Detalle solo en ambos archivos.
`OPENSHOT_LOG_CONSOLE_LEVEL`	Detalle solo en la terminal, para ambas partes de OpenShot.
`LIBOPENSHOT_LOG_LEVEL`	Detalle para el motor de video y audio, en su archivo y en la terminal.
`LIBOPENSHOT_LOG_FILE_LEVEL`	Detalle solo en `libopenshot.log`.
`LIBOPENSHOT_LOG_CONSOLE_LEVEL`	Detalle del motor solo en la terminal.

Por ejemplo, este comando de terminal en Linux/macOS solicita un registro detallado del motor en su archivo para un lanzamiento:

LIBOPENSHOT_LOG_FILE_LEVEL=debug openshot-qt

Si las configuraciones se superponen, las opciones de línea de comandos tienen prioridad, seguidas por las variables de entorno, luego las Preferencias y finalmente los valores predeterminados normales. Cada control afecta solo la salida que describe: --debug no anula la preferencia del motor. Las anulaciones temporales no cambian tus preferencias guardadas. Pasa el cursor sobre cualquier casilla para ver si otra configuración controla ese archivo de registro.

Dentro de las configuraciones de entorno, los valores LIBOPENSHOT_ tienen prioridad sobre los valores OPENSHOT_ para el motor. Dentro de cada grupo, un nivel solo para archivo o solo para consola tiene prioridad sobre el nivel general. Las opciones de línea de comandos siguen la misma regla archivo/consola. Se rechazan niveles conflictivos en línea de comandos para la misma salida; los niveles inválidos de entorno se reportan y se ignoran.

Para scripts antiguos, LIBOPENSHOT_DEBUG aún habilita mensajes detallados del motor en la terminal siempre que esté presente, incluso si su valor es 0. Las configuraciones de nivel más recientes tienen prioridad sobre él. LIBOPENSHOT_LOG_FILE está destinado a programas que usan el motor por separado; OpenShot usa la carpeta de registro mencionada arriba. Cambiar la configuración de registro no modifica tu preferencia de reporte de errores.

Windows 11 no responde

Si experimenta un bloqueo en Windows 11, este es un problema conocido con PyQt5 y Windows 11, relacionado con las funciones de accesibilidad en Qt. Se activa al presionar Ctrl+C en OpenShot (solo en Windows 11). OpenShot dejará de responder y también habrá una fuga de memoria (es decir, cuanto más tiempo OpenShot no responda, mayor será la fuga de memoria hasta que OpenShot finalmente se bloquee o el usuario termine el proceso).

Una solución sencilla es evitar Ctrl+C en Windows 11 y, en su lugar, usar los menús de copiar/pegar con clic derecho. Otra solución es reasignar la función «Copiar» de Ctrl+C a otra combinación, por ejemplo Alt+C. Puede cambiar las asignaciones del teclado en las Preferencias de OpenShot. Consulte Teclado.

Depuración en Windows con GDB

Si experimenta un bloqueo o congelamiento con OpenShot en Windows 10/11, las siguientes instrucciones paso a paso le ayudarán a determinar la causa del fallo. Estas instrucciones mostrarán un rastreo de pila del código fuente de OpenShot, en el lugar del fallo. Esta información puede ser extremadamente útil para nuestro equipo de desarrollo y muy útil para adjuntar a los informes de errores (para una resolución más rápida).

Instalar la última versión diaria

Antes de adjuntar un depurador, descargue la última versión de OpenShot: https://www.openshot.org/download#daily. Instale esta versión de OpenShot en la ubicación predeterminada: C:\Program Files\OpenShot Video Editor\. Para instrucciones detalladas sobre cómo depurar OpenShot en Windows, consulte esta wiki.

Instalar MSYS2

La versión de OpenShot para Windows se compila usando un entorno llamado MSYS2. Para adjuntar el depurador GDB a nuestro ejecutable, openshot-qt.exe, primero debe instalar MSYS2. Este paso solo se requiere una vez.

Descargar e instalar MSYS2: http://www.msys2.org/
Ejecute el símbolo del sistema MSYS2 MinGW x64 (por ejemplo: C:\msys64\msys2_shell.cmd -mingw64)
Actualice todos los paquetes (Copie/Pegue el siguiente comando):
```
pacman -Syu
```

Instale el depurador GDB (Copie/Pegue el siguiente comando):

pacman -S --needed --disable-download-timeout mingw-w64-x86_64-toolchain

Iniciar OpenShot con el depurador GDB

Ejecute el símbolo del sistema MSYS2 MinGW x64 (por ejemplo: C:\msys64\msys2_shell.cmd -mingw64)

Actualice la variable PATH (Copie/Pegue los siguientes comandos):

export PATH="/c/Program Files/OpenShot Video Editor/lib:$PATH"
export PATH="/c/Program Files/OpenShot Video Editor/lib/PyQt5:$PATH"

Cargue OpenShot en el depurador GDB (Copie/Pegue los siguientes comandos):

cd "/c/Program Files/OpenShot Video Editor"/
gdb openshot-qt.exe

Inicie OpenShot desde el prompt de GDB (Copie/Pegue el siguiente comando):

run --debug

Imprimir información de depuración

Una vez que OpenShot se haya iniciado correctamente con GDB adjunto, solo debe provocar un bloqueo o congelamiento en OpenShot. Cuando ocurra un bloqueo, vuelva al terminal MSYS2 MinGW64 y ejecute uno de los siguientes comandos (escribiéndolo y presionando ENTER). Normalmente, el primer comando a ingresar es bt, que significa backtrace. Más comandos se listan a continuación.

(gdb) run            (launch openshot-qt.exe)
(gdb) CTRL + C       (to manually break out   OR   wait for a crash / segmentation fault)
(gdb) bt             (Print stack trace for the current thread #)
(gdb) info threads   (to view all threads, and what they are doing. Look for `__lll_lock_wait` for Mutex/deadlocks)
(gdb) thread 35      (Switch to thread number, for example thread 35)

Monitores de Alta DPI / 4K

OpenShot Video Editor ofrece un soporte robusto para monitores de Alta DPI (puntos por pulgada), asegurando que la interfaz se vea nítida y sea fácilmente legible en pantallas con diferentes configuraciones de DPI. Este soporte es especialmente útil en monitores 4K y otras pantallas de alta resolución.

Conciencia de DPI por Monitor

OpenShot es consciente del DPI por monitor, lo que significa que puede ajustar su escala dinámicamente según la configuración de DPI de cada monitor conectado. Esto ayuda a proporcionar una experiencia consistente en diferentes pantallas.

Escalado de DPI en Windows

En Windows, OpenShot redondea el factor de escala al valor entero más cercano para mantener la integridad visual. Esto ayuda a evitar artefactos visuales en la interfaz y mantiene los elementos de la interfaz nítidos y bien alineados. Debido a este redondeo, algunas opciones de escala pueden resultar en fuentes y elementos de interfaz más grandes de lo esperado.

El escalado del 125% se redondea a 100%
El escalado del 150% se redondea a 200%

Soluciones para Ajustes Más Precisos

Aunque el redondeo ayuda a mantener una interfaz limpia, existen soluciones para usuarios que requieren un control más preciso sobre el escalado. Estos métodos no son recomendados debido a posibles artefactos visuales:

QT_SCALE_FACTOR_ROUNDING_POLICY=PassThrough
- Configurar esta variable de entorno puede desactivar el redondeo y permitir un escalado más preciso.
- Nota: Esto puede causar artefactos visuales, especialmente en la línea de tiempo, y no es recomendable.
QT_SCALE_FACTOR=1.25 (o un valor similar)
- Configurar manualmente el factor de escala puede proporcionar ajustes más finos en la escala de fuentes y la interfaz.
- Esto también puede configurarse desde Preferencias (Escala de la Interfaz de Usuario), pero se pueden esperar problemas con bordes/líneas en Windows con escalas fraccionarias.
- Nota: Este método también puede causar artefactos visuales y dificultar el uso de OpenShot.

Para más información sobre cómo ajustar estas variables de entorno, por favor visite https://github.com/OpenShot/openshot-qt/wiki/OpenShot-UI-too-large.