Como o Stacher usa o yt-dlp
O Stacher é uma interface de desktop. Ele reúne URL, preset, pasta, autenticação e pós-processamento e cria uma tarefa para o yt-dlp. O yt-dlp reconhece o site, encontra fluxos de vídeo e áudio, baixa os arquivos e usa o FFmpeg para unir ou converter quando necessário.
Problemas de fila ou configuração geralmente pertencem ao Stacher; mensagens de extractor, assinatura, HTTP ou formato pertencem ao yt-dlp; falhas de merge ou codec apontam para o FFmpeg. Leia o primeiro erro específico do log.
| Componente | Responsabilidade | Evidência |
|---|---|---|
| Stacher | Interface, fila, presets, pasta e controles do componente | Fila, configuração, caminho ou branch |
| yt-dlp | Extractors, formatos, requisições e download | Versão, extractor, HTTP ou formato |
| FFmpeg | União, remux, conversão e incorporação | Erro de pós-processamento, codec ou executável |
Baixe somente conteúdo próprio ou autorizado. Atualizar o yt-dlp não libera mídia privada, paga, removida ou restrita.
yt-dlp gerenciado ou caminho personalizado
Para a maioria dos usuários, o componente gerenciado é mais seguro: o Stacher conhece o local e pode atualizá-lo. Um caminho personalizado serve para testes avançados ou ambientes controlados.
O erro mais comum é atualizar outra cópia. Um comando no terminal pode atualizar um arquivo enquanto o Stacher continua usando outro. Confirme versão e caminho no log e remova um override não intencional.
- Prefira o componente gerenciado.
- Use caminho personalizado apenas se mantiver esse arquivo.
- Evite vários executáveis parecidos.
- Reinicie e confirme o caminho após mudanças.
| Opção | Indicada para | Risco |
|---|---|---|
| Gerenciado | Instalações normais | Update interrompido pode exigir nova tentativa |
| Personalizado | Testes ou política técnica | Caminho antigo, permissões ou arquitetura |
| Pacote do sistema | Linux administrado | Repositório pode estar atrasado |
Não altere caminho e branch no mesmo teste.
Como atualizar o yt-dlp no Stacher
Atualize quando o log mostrar versão antiga, o Stacher oferecer uma atualização ou um site antes compatível apresentar erro de extractor corrigido recentemente. Espaço, pasta, permissões e FFmpeg exigem outras correções.
Depois do update, teste uma URL pública permitida, formato padrão, sem cookies ou argumentos especiais, em uma pasta local simples.
- Finalize downloads ativos.
- Abra configurações e procure yt-dlp, update, branch ou custom path.
- Anote branch e caminho atuais.
- Execute a atualização.
- Reinicie o Stacher.
- Teste uma URL pública autorizada.
- Confirme versão e caminho no log.
- Reative opções uma por vez.
Guarde a mensagem exata se falhar: antivírus, permissões, rede ou arquivo bloqueado podem impedir a substituição.
Stable, nightly ou master no Stacher
Stable é a escolha diária. Nightly muda com mais frequência e pode incluir uma correção antes da próxima stable. Master acompanha o desenvolvimento e deve ficar restrito a um diagnóstico avançado curto.
Troque de branch para testar uma correção específica. Registre a versão stable, teste a mesma URL com nightly e volte quando stable incluir o fix ou houver regressão.
| Branch | Quando usar | Quando sair |
|---|---|---|
| Stable | Uso normal e primeiro diagnóstico | Somente para teste documentado |
| Nightly | Fix recente ainda fora da stable | Quando stable incluir ou surgir regressão |
| Master | Diagnóstico avançado breve | Logo após o teste |
Registre branch e versão juntos; “latest” não é evidência suficiente.
Ler o log e corrigir falhas do Stacher yt-dlp
O log detalhado separa extractor antigo, caminho errado e pós-processamento. Registre o primeiro erro, versão, extractor, pasta e overrides ativos. Remova URLs privadas e dados de sessão antes de compartilhar.
Não cole argumentos aleatórios de fóruns. Um workaround antigo pode substituir presets e virar a causa depois de um update. Volte ao teste mínimo.
| Sintoma | Causa provável | Primeira ação |
|---|---|---|
| Unsupported URL/extractor | yt-dlp/site | Atualizar stable; nightly só com fix documentado |
| Versão antiga permanece | Caminho/cópias múltiplas | Verificar executável e remover override |
| Sem permissão para substituir | Sistema/segurança | Fechar processos e revisar permissões/quarentena |
| Formato indisponível | Seleção/origem | Voltar à seleção padrão |
| FFmpeg ausente | Pós-processamento | Instalar ou localizar FFmpeg |
| Login necessário | Autenticação | Usar sessão autorizada e guia de cookies |
| Timeout/DNS | Rede | Testar outra URL permitida e revisar firewall/proxy |
O primeiro erro específico costuma ser mais útil que a mensagem genérica final.
Notas para Windows, macOS e Linux
No Windows, o antivírus pode isolar o novo executável ou bloquear pastas protegidas. Evite cópias executadas em Downloads e verifique o histórico de proteção.
No macOS, escolha Apple silicon ou Intel e confira permissões. No Linux, pacote, ambiente Python e componente gerenciado podem coexistir; o log mostra a cópia ativa.
A pasta de saída é separada do caminho do yt-dlp. O destino final aparece no log.
- Combine sistema e arquitetura.
- Use caminho local curto nos testes.
- Evite pastas de rede ou sincronizadas.
- Anote versões, branch e caminho.
Em 23 de julho de 2026, a versão verificada do Stacher é 7.1.11; o yt-dlp tem seu próprio ciclo.
Perguntas sobre Stacher yt-dlp
O Stacher inclui yt-dlp?
O Stacher gerencia um componente yt-dlp e também pode usar caminho personalizado. O log confirma a cópia ativa.
Como atualizar o yt-dlp?
Pare tarefas, atualize nas configurações, reinicie, teste uma URL permitida e confirme versão e caminho no log.
Devo usar nightly?
Mantenha stable; use nightly temporariamente apenas para um fix recente documentado.
Por que continua a versão antiga?
O Stacher provavelmente usa outra cópia ou caminho personalizado. Verifique o executável no log.
Onde o Stacher salva vídeos?
Na pasta de saída escolhida, independente do caminho do yt-dlp. O log mostra o destino.
Atualizar corrige qualquer erro?
Não; não corrige FFmpeg, disco, permissões, rede, formatos ausentes ou restrições de conta.