Solução de Problemas

Se você está enfrentando um problema com o OpenShot, como travamento, falha ou mensagem de erro, existem várias técnicas que podem ser úteis para solucionar o problema.

Usando Logs para Solucionar um Problema

Um log é um arquivo de texto que registra o que o OpenShot está fazendo, junto com avisos e erros. Esses arquivos podem ajudar a equipe de suporte a entender um problema, mesmo quando você não vê uma mensagem de erro na tela.

O OpenShot mantém dois arquivos de log na pasta .openshot_qt dentro da sua pasta pessoal. No Linux e macOS, esse local é escrito como ~/.openshot_qt/. A pasta pode estar oculta no seu gerenciador de arquivos.

Os dois arquivos de log

Arquivo	O que ele registra
openshot-qt.log	Atividade no editor: iniciar o OpenShot, carregar projetos, alterar configurações e usar a interface. Este é geralmente o melhor lugar para começar ao investigar um problema.
libopenshot.log	Atividade no motor de vídeo e áudio do OpenShot, a parte que lê a mídia e constrói as imagens e sons usados em pré-visualizações e vídeos exportados. Logs detalhados do motor podem ajudar a investigar problemas de reprodução e exportação.

Esses arquivos registram partes diferentes da mesma aplicação. Ao relatar um problema, inclua ambos os arquivos, se disponíveis. Você não precisa entender cada linha por conta própria.

Escolha qual parte do OpenShot registrar

Abra Editar → Preferências → Avançado para encontrar essas duas configurações:

Preferências e opções correspondentes no terminal

Preferência	Argumento correspondente	Arquivo de log
Registro de Depuração da Interface do Usuário	--debug-ui	openshot-qt.log
Registro de Depuração do Motor de Vídeo e Áudio	--debug-engine	libopenshot.log

Ambas as preferências estão desativadas por padrão, o que mantém as mensagens normais de resumo. Ativar uma adiciona detalhes ao seu arquivo de log imediatamente. Isso não altera o outro log nem adiciona mensagens ao terminal. As preferências permanecem ativadas entre as execuções até que você as desative.

Registro de Depuração da Interface do Usuário é um bom ponto de partida para problemas com inicialização, carregamento de projetos, configurações ou a interface. Registro de Depuração do Motor de Vídeo e Áudio adiciona detalhes sobre o processamento de vídeo e áudio, o que pode ajudar a investigar problemas de reprodução e exportação. Os logs do motor podem crescer muito rapidamente e podem deixar o OpenShot lento. Ative essa configuração pouco antes de repetir o problema e depois desative-a.

A preferência do motor era anteriormente chamada de Modo de Depuração (Verbose). A configuração salva de ligado/desligado foi mantida para o novo nome.

Use um terminal para uma execução

Um terminal é uma janela onde você digita comandos. Os argumentos correspondentes ativam o mesmo nível extra de detalhes das preferências e também os exibem no terminal:

openshot-qt --debug-ui

Isso registra detalhes da interface para uma execução. As opções familiares --debug e a mais curta -d significam exatamente a mesma coisa que --debug-ui. Para detalhes do motor de vídeo e áudio, use:

openshot-qt --debug-engine

Para coletar ambos os tipos de detalhes juntos:

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

Repita os passos que causam o problema, depois feche o OpenShot e colete os logs. Esses argumentos não alteram suas preferências salvas. Iniciar o OpenShot normalmente retorna às suas configurações habituais de registro.

O openshot-qt.log inicia um novo arquivo quando atinge cerca de 25 MB e mantém três cópias antigas. O libopenshot.log continua crescendo à medida que mensagens são adicionadas. Após salvar os logs necessários, você pode remover arquivos de log antigos enquanto o OpenShot estiver fechado.

Outras opções de linha de comando

A maioria dos usuários precisa apenas dos dois controles acima. As opções seguintes permitem escolher quanto detalhe vai para os arquivos ou aparece no terminal. Aqui, console significa a saída do terminal.

Opções de registro

Opção	O que faz
--debug-ui, --debug ou -d	Ativa o Registro de Depuração da Interface do Usuário no arquivo e no terminal.
--debug-engine	Ativa o Registro de Depuração do Motor de Vídeo e Áudio no arquivo e no terminal.
--debug-file	Adiciona detalhes do editor ao openshot-qt.log sem adicionar detalhes no terminal.
--debug-console	Adiciona detalhes do editor no terminal sem adicionar detalhes no arquivo.
--log-level LEVEL	Define o nível de detalhe para ambos os logs e sua saída no terminal.
--log-file-level LEVEL	Define o nível de detalhe para ambos os arquivos de log, sem alterar as configurações do terminal.
--log-console-level LEVEL	Define o nível de detalhes no terminal para o editor e o motor, sem alterar as configurações de arquivo.

Substitua LEVEL por debug para mensagens detalhadas ou info para o resumo normal. warning mostra avisos e erros; error mostra erros e falhas críticas; critical mostra apenas falhas críticas. off para mensagens comuns de log, mas diagnósticos de falhas existentes ainda podem ser gravados. Nomes em maiúsculas como DEBUG também funcionam.

Por exemplo, para coletar mensagens detalhadas em ambos os arquivos mantendo o terminal no nível usual:

openshot-qt --log-file-level debug

Isso também ativa o log extenso do motor, então use-o por pouco tempo. As opções antigas --debug-file e --debug-console ainda funcionam, mesmo não estando listadas em --help.

Variáveis de ambiente

Uma variável de ambiente é uma configuração nomeada passada a um programa ao iniciar. São úteis ao iniciar o OpenShot via script ou quando um suporte técnico pede para testar uma configuração específica. Não é necessário configurá-las para uso normal.

Configurações opcionais de ambiente

Variável	O que controla
OPENSHOT_LOG_LEVEL	Detalhes em ambos os arquivos e no terminal.
OPENSHOT_LOG_FILE_LEVEL	Detalhes apenas em ambos os arquivos.
OPENSHOT_LOG_CONSOLE_LEVEL	Detalhes apenas no terminal, para ambas as partes do OpenShot.
LIBOPENSHOT_LOG_LEVEL	Detalhes para o motor de vídeo e áudio, no arquivo e no terminal.
LIBOPENSHOT_LOG_FILE_LEVEL	Detalhes apenas em libopenshot.log.
LIBOPENSHOT_LOG_CONSOLE_LEVEL	Detalhes do motor apenas no terminal.

Por exemplo, este comando no terminal Linux/macOS solicita registro detalhado do motor em seu arquivo para uma execução:

LIBOPENSHOT_LOG_FILE_LEVEL=debug openshot-qt

Se as configurações se sobrepõem, as opções da linha de comando têm prioridade, seguidas pelas variáveis de ambiente, depois Preferências e por fim os padrões normais. Cada controle afeta apenas a saída que descreve: --debug não substitui a preferência do motor. Substituições temporárias não alteram suas preferências salvas. Passe o mouse sobre qualquer caixa de seleção para ver se outra configuração está controlando aquele arquivo de log.

Dentro das configurações de ambiente, os valores LIBOPENSHOT_ têm prioridade sobre os valores OPENSHOT_ para o motor. Dentro de cada grupo, um nível apenas para arquivo ou apenas para console tem prioridade sobre o nível geral. As opções da linha de comando seguem a mesma regra arquivo/console. Níveis conflitantes na linha de comando para a mesma saída são rejeitados; níveis inválidos de ambiente são reportados e ignorados.

Para scripts antigos, LIBOPENSHOT_DEBUG ainda ativa mensagens detalhadas do motor no terminal sempre que presente, mesmo que seu valor seja 0. As configurações de nível mais recentes têm prioridade sobre ele. LIBOPENSHOT_LOG_FILE é destinado a programas que usam o motor separadamente; o próprio OpenShot usa a pasta de logs acima. Alterar as configurações de log não muda sua preferência de relatório de erros.

Windows 11 Não Responde

Se você experimentar um travamento no Windows 11, este é um problema conhecido com PyQt5 e Windows 11, relacionado aos recursos de acessibilidade no Qt. Isso é acionado ao pressionar Ctrl+C no OpenShot (apenas no Windows 11). O OpenShot ficará sem resposta e também haverá um vazamento de memória (ou seja, quanto mais tempo o OpenShot ficar sem resposta, maior será o vazamento de memória até que o OpenShot finalmente trave ou o usuário encerre o processo).

Uma solução simples é evitar usar Ctrl+C no Windows 11 e, em vez disso, usar os menus de copiar/colar do clique direito. Outra solução é remapear o comando «Copiar» de Ctrl+C para outra tecla, por exemplo Alt+C. Você pode alterar os atalhos de teclado nas Preferências do OpenShot. Veja Teclado.

Depuração no Windows com GDB

Se você está enfrentando uma falha ou travamento com o OpenShot no Windows 10/11, as instruções passo a passo a seguir ajudarão a determinar a causa da falha. Essas instruções exibirão um rastreamento de pilha do código-fonte do OpenShot, no local da falha. Essas informações podem ser extremamente úteis para nossa equipe de desenvolvimento e muito úteis para anexar aos relatórios de bugs (para uma resolução mais rápida).

Instale a Versão Diária Mais Recente

Antes de anexar um depurador, por favor baixe a versão mais recente do OpenShot: https://www.openshot.org/download#daily. Instale esta versão do OpenShot no local padrão: C:\Program Files\OpenShot Video Editor\. Para instruções detalhadas sobre depuração do OpenShot no Windows, consulte este wiki.

Instale o MSYS2

A versão do OpenShot para Windows é compilada usando um ambiente chamado MSYS2. Para anexar o depurador GDB ao nosso executável, openshot-qt.exe, você deve primeiro instalar o MSYS2. Esta etapa é necessária apenas uma vez.

1. Baixe e Instale o MSYS2: http://www.msys2.org/

2. Execute o prompt de comando MSYS2 MinGW x64 (por exemplo: C:\msys64\msys2_shell.cmd -mingw64)

3. Atualize todos os pacotes (Copie/cole o seguinte comando):

   pacman -Syu
   

4. Instale o depurador GDB (Copie/cole o seguinte comando):

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

Inicie o OpenShot com o Depurador GDB

Execute o prompt de comando MSYS2 MinGW x64 (por exemplo: C:\msys64\msys2_shell.cmd -mingw64)

Atualize o PATH (Copie/cole os seguintes comandos):

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

Carregue o OpenShot no depurador GDB (Copie/cole os seguintes comandos):

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

Inicie o OpenShot a partir do prompt do GDB (Copie/cole o seguinte comando):

run --debug

Imprimir Informações de Depuração

Depois que o OpenShot for iniciado com sucesso com o GDB anexado, tudo o que você precisa fazer é provocar uma falha ou travamento no OpenShot. Quando ocorrer uma falha, volte ao terminal MSYS2 MinGW64 e execute um dos seguintes comandos (digitando-o e pressionando ENTER). Normalmente, o primeiro comando a ser inserido é bt, que significa backtrace. Mais comandos estão listados abaixo.

(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

O OpenShot Video Editor oferece suporte robusto para monitores de Alta DPI (Pontos Por Polegada), garantindo que a interface fique nítida e facilmente legível em telas com várias configurações de DPI. Esse suporte é especialmente útil em monitores 4K e outras telas de alta resolução.

Consciência de DPI por Monitor

O OpenShot reconhece o DPI individualmente para cada monitor, o que significa que pode ajustar sua escala dinamicamente conforme as configurações de DPI de cada monitor conectado. Isso ajuda a proporcionar uma experiência consistente em diferentes telas.

Escalonamento de DPI no Windows

No Windows, o OpenShot arredonda o fator de escala para o valor inteiro mais próximo para manter a integridade visual. Isso ajuda a evitar artefatos visuais na interface e mantém os elementos da interface nítidos e bem alinhados. Devido a esse arredondamento, algumas opções de escala podem resultar em fontes e elementos da interface maiores do que o esperado.

• Escala de 125% arredonda para 100%

• Escala de 150% arredonda para 200%

Soluções Alternativas para Ajustes Precisos

Embora o arredondamento ajude a manter uma interface limpa, existem soluções alternativas para usuários que precisam de controle mais preciso sobre a escala. Esses métodos não são recomendados devido a possíveis artefatos visuais:

• QT_SCALE_FACTOR_ROUNDING_POLICY=PassThrough

  • Definir essa variável de ambiente pode desabilitar o arredondamento e permitir uma escala mais precisa.

  • Nota: Isso pode causar artefatos visuais, especialmente na linha do tempo, e não é recomendado.

• QT_SCALE_FACTOR=1.25 (ou valor similar)

  • Definir manualmente o fator de escala pode proporcionar ajustes mais finos na escala da fonte e da interface.

  • Isso também pode ser configurado via Preferências (Escala da Interface do Usuário), mas espere problemas de bordas/linhas no Windows com escalas fracionárias.

  • Nota: Este método também pode causar artefatos visuais e tornar o OpenShot mais difícil de usar.

Para mais informações sobre como ajustar essas variáveis de ambiente, por favor visite https://github.com/OpenShot/openshot-qt/wiki/OpenShot-UI-too-large.