1  ### 1. O programa relata "Arquivo de configuração não encontrado" ou "xxxxx requer configuração da chave da API xxxxx." Como posso corrigir isso?
  2  
  3  Este é um problema comum de configuração. Existem algumas razões pelas quais isso pode acontecer:
  4  
  5  1. **Localização ou Nome do Arquivo Incorretos:**
  6  
  7  * O programa requer um arquivo de configuração nomeado exatamente `config.toml`. Certifique-se de que você não o nomeou acidentalmente como `config.toml.txt`.
  8  * Este arquivo deve ser colocado dentro de uma pasta `config`. A estrutura correta do diretório de trabalho deve ser:
  9    ```
 10    /── config/
 11    │   └── config.toml
 12    └── krillinai.exe (seu arquivo executável)
 13    ```
 14  * **Para usuários do Windows:** É recomendável colocar todo o diretório do software em uma pasta que não esteja na unidade C: para evitar possíveis problemas de permissão.
 15  
 16  2. **Configuração Incompleta da Chave da API:**
 17  
 18  * O aplicativo requer configurações separadas para o modelo de linguagem grande (para tradução), o serviço de voz (para transcrição e síntese de fala) e o serviço de tts.
 19  * Mesmo que você use a OpenAI para tudo, deve preencher a chave em diferentes seções do arquivo `config.toml`. Procure pela seção `llm`, a seção `transcribe`, a seção `tts` e preencha as respectivas Chaves da API e outras informações necessárias.
 20  
 21  ### 2. Estou recebendo um erro que contém "erro yt-dlp." O que devo fazer?
 22  
 23  Esse erro aponta para um problema com o downloader de vídeo, que geralmente está relacionado à sua rede ou à versão do downloader.
 24  
 25  * **Rede:** Se você usa um proxy, certifique-se de que ele está configurado corretamente nas configurações de proxy dentro do seu arquivo `config.toml`.
 26  * **Atualizar `yt-dlp`:** A versão do `yt-dlp` incluída com o software pode estar desatualizada. Você pode atualizá-la manualmente abrindo um terminal no diretório `bin` do software e executando o comando:
 27    ```
 28    ./yt-dlp.exe -U
 29    ```
 30    
 31    (Substitua `yt-dlp.exe` pelo nome correto do arquivo para o seu sistema operacional, se for diferente).
 32  
 33  ### 3. As legendas no vídeo final estão embaralhadas ou aparecem como blocos quadrados, especialmente no Linux.
 34  
 35  Isso é quase sempre causado pela falta de fontes no sistema, particularmente aquelas que suportam caracteres chineses. Para corrigir isso, você precisa instalar as fontes necessárias.
 36  
 37  1. Baixe as fontes necessárias, como [Microsoft YaHei](https://modelscope.cn/models/Maranello/KrillinAI_dependency_cn/resolve/master/%E5%AD%97%E4%BD%93/msyh.ttc) e [Microsoft YaHei Bold](https://modelscope.cn/models/Maranello/KrillinAI_dependency_cn/resolve/master/%E5%AD%97%E4%BD%93/msyhbd.ttc).
 38  2. Crie um novo diretório de fontes: `sudo mkdir -p /usr/share/fonts/msyh`.
 39  3. Copie os arquivos de fonte `.ttc` baixados para este novo diretório.
 40  4. Execute os seguintes comandos para reconstruir o cache de fontes:
 41      ```
 42      cd /usr/share/fonts/msyh
 43      sudo mkfontscale
 44      sudo mkfontdir
 45      sudo fc-cache -fv
 46      ```
 47  
 48  ### 4. No macOS, o aplicativo não inicia e mostra um erro como "KrillinAI está danificado e não pode ser aberto."
 49  
 50  Isso é causado pelo recurso de segurança do macOS, Gatekeeper, que restringe aplicativos de desenvolvedores não identificados. Para corrigir isso, você deve remover manualmente o atributo de quarentena.
 51  
 52  1. Abra o aplicativo **Terminal**.
 53  2. Digite o comando `xattr -cr` seguido de um espaço, e arraste o arquivo `KrillinAI.app` da sua janela do Finder para o Terminal. O comando ficará assim:
 54      ```
 55      xattr -cr /Applications/KrillinAI.app
 56      ```
 57  3. Pressione Enter. Agora você deve conseguir abrir o aplicativo.
 58  
 59  ### 5. Estou recebendo erros como `erro ffmpeg`, `erro audioToSrt` ou `status de saída 1` durante o processamento.
 60  
 61  Esses erros geralmente apontam para problemas com dependências ou recursos do sistema.
 62  
 63  * **`erro ffmpeg`:** Isso indica que o `ffmpeg` não está instalado ou não é acessível a partir do PATH do sistema. Certifique-se de ter uma versão completa e oficial do `ffmpeg` instalada e que sua localização esteja adicionada às variáveis de ambiente do seu sistema.
 64  * **`erro audioToSrt` ou `status de saída 1`:** Este erro ocorre durante a fase de transcrição (áudio para texto). As causas comuns são:
 65    * **Problemas com o Modelo:** O modelo de transcrição local (por exemplo, `fasterwhisper`) falhou ao carregar ou foi corrompido durante o download.
 66    * **Memória Insuficiente (RAM):** Executar modelos locais é intensivo em recursos. Se sua máquina ficar sem memória, o sistema operacional pode encerrar o processo, resultando em um erro.
 67    * **Falha na Rede:** Se você estiver usando um serviço de transcrição online (como a API Whisper da OpenAI), isso indica um problema com sua conexão de rede ou uma chave da API inválida.
 68  
 69  ### 6. A barra de progresso não está se movendo. O programa está congelado?
 70  
 71  Não, enquanto você não ver uma mensagem de erro, o programa está funcionando. A barra de progresso só é atualizada após uma tarefa importante (como transcrição ou codificação de vídeo) ser totalmente concluída. Essas tarefas podem levar muito tempo, fazendo com que a barra de progresso pause por um período prolongado. Por favor, tenha paciência e aguarde a conclusão da tarefa.
 72  
 73  ### 7. Minha GPU da série NVIDIA 5000 não é suportada pelo `fasterwhisper`. O que devo fazer?
 74  
 75  Foi observado que o modelo `fasterwhisper` pode não funcionar corretamente com GPUs da série NVIDIA 5000 (a partir de meados de 2025). Você tem algumas alternativas para transcrição:
 76  
 77  1. **Use um Modelo Baseado em Nuvem:** Defina `transcribe.provider.name` como `openai` ou `aliyun` no seu arquivo `config.toml`. Em seguida, preencha a chave da API correspondente e os detalhes de configuração. Isso usará o modelo Whisper do provedor de nuvem em vez do local.
 78  2. **Use Outro Modelo Local:** Você pode experimentar outros modelos de transcrição locais, como o original `whisper.cpp`.
 79  
 80  ### 8. Como posso encontrar e preencher o código de voz/tom correto para texto-para-fala?
 81  
 82  As vozes disponíveis e seus códigos correspondentes são definidos pelo provedor de serviço de voz que você está usando. Consulte a documentação oficial deles.
 83  
 84  * **OpenAI TTS:** [Documentação](https://platform.openai.com/docs/guides/text-to-speech/api-reference) (veja as opções de `voice`).
 85  * **Alibaba Cloud:** [Documentação](https://help.aliyun.com/zh/isi/developer-reference/overview-of-speech-synthesis) (veja o parâmetro `voice` na lista de tons).
 86  
 87  ### 9. Como posso usar um Modelo de Linguagem Grande (LLM) local, como um rodando no Ollama, para tradução?
 88  
 89  Sim, você pode configurar o KrillinAI para usar qualquer LLM local que forneça um endpoint de API compatível com OpenAI.
 90  
 91  1. **Inicie Seu LLM Local:** Certifique-se de que seu serviço local (por exemplo, Ollama rodando Llama3) esteja ativo e acessível.
 92  2. **Edite `config.toml`:** Na seção para o modelo de linguagem grande (tradutor):
 93  
 94  * Defina o `name` (ou `type`) do provedor como `"openai"`.
 95  * Defina a `api_key` como qualquer string aleatória (por exemplo, `"ollama"`), pois não é necessária para chamadas locais.
 96  * Defina o `base_url` para o endpoint da API do seu modelo local. Para Ollama, isso é tipicamente `http://localhost:11434/v1`.
 97  * Defina o `model` como o nome do modelo que você está servindo, por exemplo, `"llama3"`.
 98  
 99  ### 10. Posso personalizar o estilo das legendas (fonte, tamanho, cor) no vídeo final?
100  
101  Não. Atualmente, o KrillinAI gera **legendas codificadas**, o que significa que elas são queimadas diretamente nos quadros do vídeo. O aplicativo **não oferece opções para personalizar o estilo das legendas**; ele usa um estilo predefinido.
102  
103  Para personalização avançada, a solução alternativa recomendada é:
104  
105  1. Usar o KrillinAI para gerar o arquivo de legenda traduzido `.srt`.
106  2. Importar seu vídeo original e este arquivo `.srt` em um editor de vídeo profissional (por exemplo, Premiere Pro, Final Cut Pro, DaVinci Resolve) para aplicar estilos personalizados antes da renderização.
107  
108  ### 11. Eu já tenho um arquivo `.srt` traduzido. O KrillinAI pode usá-lo apenas para fazer a dublagem?
109  
110  Não, esse recurso não é atualmente suportado. O aplicativo executa um pipeline completo desde a transcrição até a geração do vídeo final.