Documentação/ Guias práticos/ Solução de problemas e logs
Guia prático

Solução de problemas e logs

Quando algo parece errado, o arquivo de log é o primeiro lugar para olhar.

Arquivo de log %AppData%\MaxTo\maxto-log.json
Objetivo
O problema identificado — pelo arquivo de log ou por um dos casos conhecidos abaixo.

Encontre o arquivo de log

O MaxTo grava um log em JSON em:

%AppData%MaxTomaxto-log.json

O log é rotacionado diariamente e por tamanho, então normalmente você vai ver um ou dois arquivos .json ao lado dele. O arquivo mais recente é o que interessa.

Cada linha é um objeto JSON — abra o arquivo em qualquer editor de texto e pesquise o termo relacionado ao seu problema.

Problemas comuns

Minha tecla de atalho não faz nada

Provavelmente outro aplicativo já registrou a mesma combinação. Pesquise Failed to register hotkey no log; essa linha indica a combinação que o MaxTo não conseguiu registrar.

Escolha outra combinação em Configurações → Atalhos. Veja Personalize suas teclas de atalho para saber quais combinações costumam estar livres.

O MaxTo não move uma janela específica

Se a janela pertence a um aplicativo executado com privilégios elevados (“como administrador”), o Windows impede que um MaxTo sem privilégios elevados a mova — isso é uma barreira de segurança do Windows, e não uma configuração do MaxTo. A grade mostra uma explicação quando a janela ativa tem privilégios elevados. Não há solução alternativa a não ser deixar de executar o aplicativo com privilégios elevados; veja Como o MaxTo lembra posições para entender o contexto.

A grade tem um fundo preto

Isso é esperado em sistemas em que o Windows não consegue renderizar o Mica — mais comumente sessões de área de trabalho remota e máquinas virtuais sem aceleração de GPU ou com a transparência desativada. O funcionamento não é afetado; a grade continua funcionando corretamente.

A avaliação diz que expirou logo depois que instalei

O MaxTo detecta quando o relógio é atrasado. Se o relógio do seu sistema voltar mais de uma hora, o MaxTo considera a avaliação expirada para evitar que ela seja reiniciada indefinidamente.

Acerte o relógio do sistema para a hora atual correta e abra o MaxTo de novo. A avaliação continua de onde deveria.

Relate um bug

Se algo não está funcionando e o log não ajuda, abra uma issue no GitHub em https://github.com/domino-as/maxto/issues. Anexe o arquivo de log relevante (ou as linhas que parecem relacionadas) e descreva o que você esperava e o que aconteceu.