Solução de problemas

Este guia reúne os problemas mais comuns do FloSync e como resolvê-los. Se o que você procura não estiver aqui, consulte as Perguntas Frequentes ou entre em contato com o suporte.

Logs de diagnóstico #

O FloSync gera logs detalhados que ajudam a identificar a causa de problemas. Eles são úteis para investigar falhas de sincronização, entender o que aconteceu em uma sessão ou agilizar o atendimento do suporte.

Como acessar os logs #

Pelo menu:

• macOS: Ajuda > Abrir pasta de registros
• Windows: Ajuda > Abrir pasta de registros

Localização manual:

• macOS: ~/Library/Application Support/FloSync/logs/
• Windows: %APPDATA%/FloSync/logs/

Estrutura dos logs #

Os logs são organizados por data e hora:

logs/
├── 2026-01-19/
│   ├── 00.log    (meia-noite à 1h)
│   ├── 01.log    (1h às 2h)
│   ├── ...
│   └── 23.log    (23h à meia-noite)
├── 2026-01-18/
│   └── ...

Retenção dos logs #

Os logs são mantidos por 7 dias e removidos automaticamente na inicialização do FloSync. Isso garante histórico suficiente para diagnóstico sem ocupar espaço em disco desnecessariamente.

Conteúdo dos logs #

Os logs registram, com data e hora, eventos como:

• Inicialização e encerramento do aplicativo
• Carregamento e reprodução de vídeo
• Eventos e correções de sincronização
• Conexões e desconexões da sincronização em rede
• Transições de cena durante a reprodução agendada
• Erros e avisos

Como usar os logs para diagnóstico #

1. Reproduza o problema — Anote o horário aproximado em que ele ocorreu
2. Abra a pasta de logs — Use Ajuda > Abrir pasta de registros
3. Localize o arquivo correto — Vá até a pasta da data e abra o log referente ao horário
4. Procure erros — Busque entradas marcadas como "ERROR" ou "WARN"
5. Analise o contexto — Leia as entradas anteriores e posteriores ao erro para entender o cenário

Ao entrar em contato com o suporte, anexe os arquivos de log relevantes para agilizar o diagnóstico.

Problemas de carregamento de conteúdo #

Imagem não carrega #

Sintomas: Arrastar uma imagem para o FloSync não surte efeito, ou surge uma mensagem de erro.

Possíveis causas e soluções:

1. Formato não suportado

   • Formatos aceitos: PNG, JPG/JPEG, GIF, BMP, TIFF, WebP, SVG
   • Confirme que o arquivo não está corrompido abrindo-o em outro visualizador de imagens

2. Permissões de arquivo

   • Verifique se você tem permissão de leitura no arquivo
   • Se o arquivo estiver em um compartilhamento de rede, tente copiá-lo para um disco local

3. Limitações de SVG

   • Alguns recursos avançados de SVG podem não ser renderizados corretamente
   • Se o SVG não exibir como esperado, converta-o para PNG

Página web não carrega #

Sintomas: A página web aparece em branco ou exibe um erro na tela.

Possíveis causas e soluções:

1. HTTP vs HTTPS

   • Somente URLs HTTPS são aceitas (HTTP não é suportado)
   • Confirme que a URL começa com https://

2. Conectividade de rede

   • Verifique se há acesso à internet
   • Teste se o site abre normalmente em um navegador

3. Site bloqueia incorporação

   • Alguns sites impedem a exibição em WebViews
   • Tente outro site ou use um arquivo HTML local

Problemas de reprodução de vídeo #

Vídeo não carrega #

Sintomas: Arrastar um vídeo para o FloSync não surte efeito, ou surge uma mensagem de erro.

Possíveis causas e soluções:

1. Formato não suportado

   • Tente converter para MP4 (H.264) — veja Recomendações de codec abaixo
   • Confirme que o arquivo não está corrompido reproduzindo-o em outro player

2. Codecs ausentes

   • O FloSync já inclui os codecs mais comuns, mas alguns formatos proprietários podem não funcionar
   • Converta o vídeo para um formato padrão como MP4

3. Permissões de arquivo

   • Verifique se você tem permissão de leitura no arquivo
   • Se o arquivo estiver em um compartilhamento de rede, tente copiá-lo para um disco local

Vídeo engasga ou perde frames #

Sintomas: A reprodução fica irregular ou com travamentos.

Soluções:

1. Verifique o uso de CPU/GPU — Se estiver no limite, o hardware pode não dar conta da resolução do vídeo
2. Use armazenamento SSD — Discos rígidos podem não ter velocidade de leitura suficiente para vídeos de alto bitrate
3. Reduza a resolução do vídeo — Recodifique em resolução menor caso o hardware esteja sobrecarregado
4. Feche outros aplicativos — Libere recursos do sistema
5. Ajuste a tolerância de sincronização — Se estiver usando sincronização, aumente a tolerância para reduzir o número de correções

Problemas com telas #

Segunda tela não detectada #

Sintomas: O FloSync exibe apenas uma tela quando há várias conectadas.

Soluções:

1. Verifique as configurações de tela do sistema operacional

   • macOS: Ajustes do Sistema > Monitores
   • Windows: Configurações > Sistema > Tela
   • Confirme que todas as telas estão sendo reconhecidas pelo sistema

2. Verifique os cabos

   • Experimente cabos diferentes
   • Teste portas diferentes no computador

3. Reinicie o FloSync após conectar novas telas

   • O FloSync detecta as telas na inicialização

Arranjo de telas não corresponde #

Sintomas: No modo Estendido, as seções do vídeo aparecem nas telas erradas.

Soluções:

1. Configure o arranjo de telas no sistema operacional

   • macOS: Ajustes do Sistema > Monitores > Organizar
   • Windows: Configurações > Sistema > Tela (arraste para reorganizar)
   • O arranjo virtual deve espelhar a disposição física das telas

2. Reinicie o FloSync após alterar o arranjo

Problemas de sincronização #

Telas dessincronizadas (local) #

Sintomas: Nos modos Espelhado ou Estendido, as telas mostram frames diferentes.

Soluções:

1. Aguarde a correção automática — O FloSync corrige drift persistente de forma automática
2. Observe a barra de status — Durante o modo live, o contador de correções de sincronização indica quantas correções foram realizadas:
   • Contagens baixas são normais em sessões longas
   • Contagens que crescem rapidamente podem indicar problema na configuração
3. Reduza a tolerância de sincronização — Ajuste a tolerância em Preferências
4. Consulte o log de sincronização — Procure avisos de drift e correções
5. Reinicie a reprodução — Pause e retome o vídeo

Sincronização em rede não funciona #

Sintomas: O cliente não encontra o servidor, ou a sincronização falha após a conexão.

Soluções:

1. Mesma rede

   • Os dois computadores precisam estar na mesma rede local
   • Confirme fazendo ping entre as máquinas

2. Mesmo arquivo de vídeo

   • Os clientes precisam ter o mesmo vídeo carregado
   • Se os vídeos tiverem durações diferentes, a sincronização vai falhar

3. Firewall

   • Libere o FloSync no firewall de ambas as máquinas
   • Permita a porta UDP 9201

4. Servidor ativo

   • Confirme que o ícone do servidor (torre) está verde na barra superior
   • Verifique se a barra de status exibe "Server"
   • Tente clicar no ícone para parar e reiniciar o modo servidor

5. Estabilização inicial

   • A sincronização em rede pode levar alguns instantes para se estabilizar após a conexão
   • Algumas correções iniciais são normais
   • Após esse período, a reprodução deve permanecer estável e visualmente alinhada

Drift gradual após dias de operação contínua #

Sintomas: A sincronização em rede estava perfeita, mas após vários dias de operação contínua o cliente fica persistentemente 50–100 ms defasado, sem se corrigir por completo.

Causa: O relógio interno de cada computador deriva em ritmo ligeiramente diferente ao longo do tempo, devido a variações no oscilador de hardware e à temperatura ambiente. Após dias ininterruptos, esse drift acumulado pode ultrapassar a capacidade de compensação em tempo real. Esse comportamento afeta qualquer sistema de sincronização baseado em relógio, não apenas o FloSync.

Solução: Reinicie ambos os computadores. Em instalações autônomas, programe uma reinicialização diária fora do horário de operação — veja Agendar reinicializações regulares no guia de otimização de sincronização.

Correções de sincronização causam travamentos #

Sintomas: O vídeo salta ou trava com frequência durante a reprodução.

Soluções:

1. Aumente a tolerância de sincronização em Preferências
2. Verifique a qualidade da rede (para sincronização em rede)
3. Reduza a carga do sistema — feche aplicativos desnecessários
4. Analise o log de sincronização em busca de padrões

Problemas com o Entrar ao vivo #

Janelas em tela cheia não aparecem #

Sintomas: Clicar em Entrar ao vivo não abre janelas em tela cheia nas telas.

Soluções:

1. Verifique a detecção de telas

   • Confirme que as telas estão sendo detectadas (devem aparecer na área de arranjo)
   • Tente desconectar e reconectar as telas
   • Reinicie o FloSync após conectar novas telas

2. Verifique se há conteúdo carregado

   • É necessário ter pelo menos um vídeo carregado antes de acionar o Entrar ao vivo
   • Procure indicadores de "missing video"

3. Verifique as permissões

   • No macOS, confirme que o FloSync tem permissão para controlar o computador (Ajustes do Sistema > Privacidade e Segurança > Acessibilidade)
   • No Windows, tente executar o FloSync como administrador

Tecla ESC não sai do modo live #

Sintomas: Pressionar ESC em uma janela em tela cheia não encerra o modo live.

Soluções:

1. Verifique se a janela está em foco — Clique na janela em tela cheia primeiro
2. Use o botão Parar ao vivo — Volte ao painel de controle e clique em "Parar ao vivo"
3. Force o encerramento se necessário — Use Cmd+Q (macOS) ou Alt+F4 (Windows) como último recurso

Problemas com o aplicativo #

FloSync não inicia #

Soluções no macOS:

1. Configurações de segurança

   • Clique com o botão direito no FloSync e selecione "Abrir"
   • Ou: Ajustes do Sistema > Privacidade e Segurança > Permitir o FloSync

2. Limpe as preferências

   • Apague: ~/Library/Application Support/com.tentekio.flosync/
   • Reinicie o FloSync

Soluções no Windows:

1. Execute como administrador

   • Clique com o botão direito no FloSync > Executar como administrador

2. Limpe as preferências

   • Apague: %APPDATA%\Tentekio\FloSync\
   • Reinicie o FloSync

3. Reinstale o Visual C++ Redistributable

   • Baixe a versão mais recente no site da Microsoft

Uso elevado de CPU/memória #

Sintomas: O FloSync consome recursos excessivos do sistema.

Soluções:

1. Comportamento esperado — A reprodução de vídeo naturalmente exige bastante processamento
2. Reduza a resolução do vídeo — Use 1080p em vez de 4K se o hardware estiver sobrecarregado
3. Reduza o número de vídeos simultâneos — No modo Independente
4. Feche o painel de log de sincronização — O registro de logs consome recursos
5. Verifique processos travados — Reinicie o FloSync se o consumo de recursos não cair quando o vídeo for interrompido

Problemas com codecs de vídeo #

Se você está enfrentando drift ou reprodução inconsistente com a sincronização em rede, o codec do vídeo pode ser a causa.

Solução rápida: Transcodifique o vídeo para H.264 All-Intra para obter o melhor desempenho de sincronização em qualquer plataforma. Para fluxos profissionais, ProRes LT (macOS) ou DNxHD (Windows) são boas alternativas.

Para orientações detalhadas sobre formatos, codecs recomendados, arquivos de teste e comandos de transcodificação com FFmpeg, consulte o guia completo de Preparação de vídeo.

Problemas conhecidos #

Limitações atuais #

• O modo Estendido pode não alinhar perfeitamente nas bordas entre monitores
• A sincronização em rede via Wi-Fi é menos confiável do que por cabo
• Conteúdos protegidos por DRM não podem ser reproduzidos
• Vídeos de resolução muito alta (8K+) podem apresentar desempenho insatisfatório dependendo do hardware
• Não é possível alterar o modo de tela durante o modo live (saia do live primeiro)
• Páginas web não podem ser estendidas entre telas (são exibidas espelhadas no modo Estendido)
• Somente URLs HTTPS são aceitas para páginas web (HTTP não é suportado)
• A sincronização em rede funciona apenas com vídeo (imagens e páginas web não são sincronizadas)

Dicas para melhor desempenho #

• Use conexões de rede cabeadas para sincronização em rede
• Mantenha os arquivos de conteúdo em armazenamento local (não em unidades de rede)
• Use configurações de tela consistentes entre sessões
• Teste toda a configuração antes de apresentações importantes
• Ao usar agendamento, teste as transições primeiro com cenas de curta duração