Solução de problemas
Anote a versão do XiaDown, o sistema operacional, a área e a página afetadas, as etapas executadas e o erro. Antes de tentar novamente, confirme que você não criará em duplicidade o mesmo grupo de tarefas.
Verificação rápida
Seção intitulada “Verificação rápida”- Confirme a versão em Configurações → Sobre.
- Verifique yt-dlp, FFmpeg e Bun em Configurações → Downloads.
- Verifique o proxy em Configurações → Rede.
- Se precisar de uma conta, verifique o login em Biblioteca → Sessões de apps.
- Volte à página afetada e atualize ou crie uma nova tarefa.
Solução por sintoma
Seção intitulada “Solução por sintoma”| Sintoma | O que verificar primeiro |
|---|---|
| O botão para iniciar um download ou conversão está desativado | Para download, verifique yt-dlp e FFmpeg; para conversão, FFmpeg. |
| Não foi possível analisar um link | Integridade do link, permissões da conta, yt-dlp e rede; use a Captura se necessário. |
| O download está lento ou falha com frequência | Reduza a concorrência de downloads; para HLS ou m3u8, reduza também a de segmentos. |
| A conversão falha | Verifique o FFmpeg e confirme que o arquivo de entrada está acessível e é compatível. |
| O navegador de captura não abre | Volte a “Nova captura” para repetir a detecção. Para “Padrão do navegador” do Chrome, verifique a depuração remota e a autorização. |
| A Captura não mostra recursos | Inicie a reprodução, role a página, amplie o escopo ou abra uma nova sessão. |
| YouTube / Música pede login | Verifique ou reconecte a sessão do YouTube. |
| Uma página online não termina de carregar | Verifique proxy, estado do serviço e região da conta. |
| RSS não atualiza | Atualize manualmente a assinatura e verifique o endereço e a rede. |
| A música local não toca | Confira se o arquivo foi movido, excluído ou está em um disco offline. |
| Um item da Biblioteca aparece como ausente | Monte novamente o disco e verifique ou importe outra vez o arquivo existente. |
Consultar logs
Seção intitulada “Consultar logs”Abra a pasta de logs em Configurações → Geral. Reproduza o problema uma vez e procure as entradas próximas desse horário.
Os logs podem conter caminhos locais, endereços de sites ou contexto do erro. Remova ou oculte esses dados antes de compartilhar. Não envie sessões, links de pareamento, tokens nem o banco de dados completo da Biblioteca.
Se o problema continuar
Seção intitulada “Se o problema continuar”Abra um relato no GitHub Issues e inclua:
- As versões do XiaDown e do sistema.
- A área e a página afetadas.
- Passos que reproduzam o problema de forma confiável.
- A mensagem ou trecho do log sem dados sensíveis.
- Uma captura sem contas, conteúdo privado ou caminhos locais.