Documentação ComusThumbz
Login de Admin

Download de vídeo YT-DLP

O que esta página faz

O sistema de download de vídeo permite baixar vídeos do YouTube, sites adultos e mais de 1000 outras plataformas diretamente em seu site. Uma vez baixado, os vídeos são automaticamente processados e adicionados ao seu site, assim como vídeos enviados. Você pode baixar vídeos individuais, configurar downloads recorrentes de canais ou listas de reprodução e gerenciar autenticação para conteúdo restrito à idade.

[Screenshot: ytdlp-hub-overview]


Como chegar aqui

Navegar para Painel de administração > Ferramentas > Hub de Importação de Vídeo


Importante: Aviso de Software de Terceiros

Nota:
O sistema de download usa o yt-dlp, que é um software de terceiros não criado ou mantido pelo ComusThumbz. Se os downloads pararem de funcionar devido às alterações do site, você precisará esperar os desenvolvedores do yt-dlp lançarem uma atualização. Verificar yt-dlp GitHub para a versão mais recente.


Compreensão do sistema

O Sistema de Transferência de Vídeo tem seis páginas que funcionam em conjunto:

PáginaPara que serve
HubSeu painel principal para gerenciar fontes de download e ver atividade recente
Transferência DirectaBaixar vídeos colando um URL
FilaMonitorizar downloads em andamento
HistóricoVer as transferências concluídas e mal- sucedidas
Gerenciador de cookiesAdicionar autenticação para o conteúdo restrito à idade
ConfiguraçõesConfigurar qualidade de download, limites de velocidade e outras opções

O que acontece depois de baixar

Vídeos baixados entram automaticamente em seu sistema de processamento de vídeo:

  1. O arquivo de vídeo é baixado para o seu servidor
  2. Seu processador de vídeo converte-o para o formato de streaming
  3. São geradas miniaturas e clipes de visualização
  4. Os ficheiros são enviados para o seu CDN
  5. O vídeo aparece em seu site

Aviso:
Os vídeos não aparecerão em seu site até que o processamento termine. Isso pode levar vários minutos para vídeos grandes.


Hub Page

O que você verá

Quando abrires o Hub, verás:

  • Cartões estatísticos no topo mostrando fontes ativas, até downloads, e downloads de hoje concluídos
  • Botões de ação rápida para tarefas comuns
  • Sua lista de fontes de download mostrando todas as fontes configuradas
  • Painel de estado do sistema à direita mostrando se o yt-dlp está instalado e pronto
  • Actividade recente mostrando os últimos 10 downloads

[Screenshot: ytdlp-hub-layout]

Estado do sistema

O painel de estado do sistema mostra:

  • status do yt-dlp - Pronto ou não instalado
  • Estado do FFmpeg - Pronto ou não instalado
  • Versão - Versão atual do yt-dlp
  • Perfis de cookies - Número de perfis de autenticação disponíveis

Aviso:
Se o yt-dlp mostrar "Não Instalado", você precisa instalá-lo primeiro. Clique no link para acessar Configurações para instruções de instalação.


Tarefas comuns

Como baixar um único vídeo

  1. Clique na Transferir o Vídeo botão na página Hub (ou vá para Download Direto do menu superior)
  2. Colar o URL do vídeo no campo de entrada
  3. Clique Obter informações ou pressione Enter
  4. Reveja a antevisão de vídeo que aparece (humbnail, título, duração, etiquetas)
  5. Verificar Sugestões de Auto- Correspondência para categorias e modelos recomendados
  6. Ajustar Qualidade dropdown se você quiser algo diferente de 720p
  7. Escolher um Categoria ou deixá- lo como Auto Detectar
  8. Escolher um Modelo ou deixá- lo como Auto Detectar
  9. Verificar ou desmarcar Remover segmentos de patrocinador (para vídeos no YouTube)
  10. Clique Adicionar à Fila de Download

Dica:
O sistema detecta automaticamente se o site necessita de cookies (como Pornhub ou xHamster) e destaca o cookie dropdown em amarelo se você precisar selecionar um.

[Screenshot: ytdlp-direct-download-preview]

Como baixar vários vídeos ao mesmo tempo

  1. Ir para o Transferência Directa página
  2. Clique na Lote aba no topo
  3. Colar vários URLs (um por linha) na área de texto
  4. Selecionar um Qualidade para usar em todos os vídeos
  5. Verificar ou desmarcar Activar o Bloco de Patrocinadores para todos os vídeos
  6. Clique Adicionar Tudo à Fila
  7. Você verá uma mensagem mostrando quantos foram adicionados com sucesso

Nota:
No modo em lote, as informações de vídeo são obtidas automaticamente no fundo. Você não verá antevisões antes de adicionar à fila.

Como configurar transferências automáticas de canais

  1. Ir para o Hub página
  2. Clique Adicionar fonte
  3. Na Basic tabulação:
  • Digite um nome como "Tech Reviews Channel"
  • Escolher Canal como o tipo
  • Colar o URL do canal completo
  • Selecione o Site do dropdown (YouTube, Pornhub, xHamster, etc.)
  • Escolha uma qualidade (720p é recomendado)
  • Definir um limite de download (10 significa que ele vai pegar os 10 mais novos vídeos de cada vez)
  • Certifique-se Activo é verificado
  1. Na Filtros tabulação:
  • Definir duração mínima e máxima (padrão 60-7200 segundos)
  • Adicionar palavras-chave include/exclude se quiser filtrar vídeos
  • Activar os cookies se o canal necessitar de autenticação
  • Activar o Bloco de Patrocinadores se quiser remover segmentos de patrocinadores
  1. Na Meta- dados tabulação:
  • Escolha uma categoria padrão ou habilite a correspondência automática
  • Activar Categorias de correspondência automática, Modelos de correspondência automática, e Marcas de correspondência automática
  1. Na Piloto automático tabulação:
  • Verificar Habilitar piloto automático
  • Escolha com que frequência procurar novos vídeos (Uma vez por dia, a cada 6 horas, etc.)
  • Definir as horas activas (as horas em que os downloads podem ser executados)
  1. Clique Gravar

Dica:
Comece com um limite de download de 10 e verifique a cada 12 horas ou uma vez por dia. Você pode ajustar mais tarde com base em quanto conteúdo você deseja.

[Screenshot: ytdlp-add-source-modal]

Como monitorar download progresso

  1. Ir para o Fila página do menu superior
  2. Veja as cartas estatísticas no topo para ver as contagens pendentes, a transferência, a conclusão e a falha
  3. Role para baixo para ver a tabela de tarefas com barras de progresso ao vivo
  4. Os downloads ativos mostram:
  • Percentagem de progresso actual
  • Velocidade de transferência (MB/s)
  • Tempo restante (ETA)
  • Atualizações em tempo real a cada poucos segundos

Nota:
A página Fila atualiza automaticamente a cada 10 segundos quando os downloads estão ativos.

Como baixar conteúdo restrito à idade

Muitos sites adultos exigem que você esteja conectado para ver vídeos restritos à idade. Para baixar estes:

  1. Ir para o Gerenciador de cookies página
  2. Procurar o Adicionar Cookies Rápidos secção no topo
  3. No seu navegador (Chrome ou Firefox):
  • Instale uma extensão de exportação de cookies (links fornecidos na página)
  • Entre no site (como Pornhub ou xHamster)
  • Clique na extensão e exportar cookies como formato Netscape
  • Copiar todo o texto exportado
  1. Voltar ao ComusThumbz, cole os dados de cookies na área de texto
  2. Digite um nome de perfil (como "cookies xHamster")
  3. Digite sites suportados (como "xhamster, pornhub")
  4. Clique Adicionar perfil de cookies
  5. Clique na Ensaio botão para verificar se os cookies funcionam

Aviso:
Os cookies expiram depois de algum tempo. A maioria dos sites exigem que você reexport cookies a cada poucas semanas ou meses. Defina um lembrete para atualizar seus cookies regularmente.

[Screenshot: ytdlp-cookie-rápido-adicionar]

Como remover segmentos de patrocinador do YouTube Vídeos

PatrocinadorBlock remove automaticamente segmentos patrocinados, intros, outros, e assina lembretes de vídeos do YouTube:

  1. Ir para Configurações do menu superior
  2. Clique na PatrocinadorBlock aba
  3. Certifique-se Activar o Bloco de Patrocinadores é verificado
  4. Verifique os segmentos que deseja remover:
  • Patrocinador - Promoções pagas (recomendadas)
  • Auto- Promoção - Produtos próprios do Criador (recomendado)
  • Introdução - Intro animações
  • Fora - Cartas finais
  • Interacção - Subscrever lembretes
  • Antevisão - Próximos visualizações de conteúdo
  • Preenchimento - tangentes fora do tópico
  1. Clique Salvar configurações do PatrocinadorBlock

Nota:
PatrocinadorBlock só funciona em vídeos do YouTube e somente se alguém tiver enviado dados de segmento para esse vídeo para o banco de dados do PatrocinadorBlock. Nem todos os vídeos têm segmentos marcados.

Como alterar a prioridade para um download

Se você tiver vários vídeos na fila e quiser que um baixe primeiro:

  1. Ir para o Fila página
  2. Encontre o vídeo que você deseja priorizar
  3. Clique no crachá de prioridade colorida (o número na primeira coluna)
  4. Selecione uma nova prioridade na lista
  5. Prioridade 1 downloads primeiro, prioridade 10 downloads último
PrioridadeCor do DistintivoQuando Usar
1-3 (Alto)VermelhoTransferências urgentes que deseja imediatamente
4-6 (Normal)AmareloPrioridade padrão
7-10 (baixo)CinzaDownloads que podem esperar

Como Cancelar ou Repetir um Download

Para cancelar uma transferência pendente:

  1. Ir para o Fila página
  2. Encontrar o vídeo (estatuto irá mostrar "Pendente")
  3. Clique na Cancelar botão (ícone amarelo)

Para parar um download ativo:

  1. Encontre o vídeo com o status "Downloading"
  2. Clique na Parar a Transferência botão (icon vermelho)
  3. Confirmar quando perguntado

Para tentar novamente uma transferência falhada:

  1. Encontre o vídeo com o status "Falhou" (passe o ícone de informação para ver por que falhou)
  2. Clique na Repetir botão (ícone azul)
  3. O vídeo é re- adicionado à fila

Dica:
Verifique a mensagem de erro (passe o ícone de informação) antes de tentar novamente. Se ele diz "403 Proibido", você pode precisar adicionar cookies. Se diz "Não é possível extrair", você pode precisar atualizar yt-dlp.


Configurações e Opções

Configuração da Transferência

ConfiguraçãoO Que FazRecomendado
Obter pastaOnde os vídeos são salvosDeixar por omissão (uploads/ftpuploads)
Transferências Max ConcorrentesQuantos vídeos podem baixar ao mesmo tempo2 para a maioria dos servidores
Qualidade PadrãoQualidade de vídeo para download720p (bom equilíbrio de qualidade e tamanho)
Limite de TaxaTransferir a tampa de velocidade em KB/s0 (ilimitado) a menos que você precise limitar a largura de banda
Repetir a ContagemTempos para repetir os downloads falhou3
Tempo- limite do socketQuanto tempo esperar antes de desistir30 segundos
URL do ProxyRoteiro de downloads através de um proxyDeixar vazio a menos que seja necessário
Geo- BypassIgnorar as restrições geográficasManter activo

Opções de Qualidade

QualidadeDesignação das mercadoriasMelhor Para
Melhor DisponívelMaior qualidade do site ofereceSites de conteúdo de alta qualidade
1080pHD completoConteúdo profissional
720pHDA maioria dos conteúdos (recomendado)
480pDefinição padrãoSalvando largura de banda/armazenamento
360pBaixa qualidadeLargura de banda muito limitada
Dica: 720p é o ponto doce para a maioria dos sites. Ele fornece boa qualidade sem consumir largura de banda excessiva ou espaço de armazenamento.

Filtros de Fila

Na página Fila, use os dropdowns do filtro para reduzir o que você vê:

FiltroOpções
EstadoTudo, Pendente, Em fila, Baixando, Processando, Concluído, Falhado, Cancelado
OrigemTodas as fontes ou uma fonte de transferência específica
PesquisarDigite palavras- chave para pesquisar títulos ou URLs

Filtros de Histórico

Na página História, você tem filtragem mais avançada:

FiltroOpções
EstadoTodos, Concluídos, Falhados, Pulados, Duplicados
OrigemTodas as fontes ou fontes específicas
SiteTodos os sites ou plataforma específica (YouTube, Pornhub, etc.)
Data DeData de início
Data AData de termo
PesquisarProcurar por título, ID ou URL

Ações em massa

Ações em massa da fila

No topo da página Fila:

AcçãoO Que FazQuando Disponível
Repetir todas as falhasRefazer todas as transferências mal- sucedidasQuando você falhou nas tarefas
Cancelar TudoCancelar todos os downloads pendentesQuando você tem trabalhos pendentes
Limpar concluídoRemover tarefas concluídas da filaSempre (escolha Todos, 7 dias ou 30 dias)

Limpeza do Histórico

Na página do Histórico:

AcçãoO Que Faz
Limpar tudo FalhouRemover todos os itens falhou
Mais de 30 diasRemover entradas com mais de 30 dias
Mais de 90 diasRemover entradas com mais de 90 dias
Limpar todo o históricoRemover todos os registos de histórico
Aviso: O histórico de limpeza só remove os registos de seguimento de transferências. Ele não exclui vídeos que já estão em seu site.

Sites Suportados

O sistema suporta mais de 1000 sites. Aqui estão os mais populares:

Sites de Vídeo Gerais

YouTube, Vimeo, Dailymotion, Twitch, TikTok, Instagram, Twitter/X, Reddit, Facebook

Sites de Tubos Adultos

Pornhub, xHamster, XVides, RedTube, SpankBang, Eporner, YouPornner, Tube8, XXXX, Beeg, Txxx, HClips, AnalDin, KeezMovies, Extreme Tube, Tube Galore, Mofos, DrTuber, VideosBang, Sunporno, FlyFlv, Empflix, Ah-Me, NuVid, GotPorrn, VPorn, e muitos mais

Plataformas Cam & Live

Chaturbate, Stripchat, BongaCams, CAM4, Camsoda, CamModels

Outros

Iwara, Sem Mãe, Regra 34Vídeo, e 1000+ mais

Nota:
Nem todos os sites funcionam perfeitamente o tempo todo. Quando um site muda seu layout ou API, o yt-dlp precisa ser atualizado por seus desenvolvedores.


Dicas para novos usuários

Dica:
  • Comece com o YouTube ou outros sites gratuitos para testar o sistema antes de lidar com autenticação
  • Utilizar sempre o Obter informações botão no Download Direto para visualizar vídeos antes de baixar
  • Configure uma ou duas fontes primeiro e monitore- as por alguns dias antes de adicionar mais
  • Verifique a página Fila regularmente quando começar a ver se os downloads estão completando com sucesso
  • Atualizar o yt-dlp mensal usando o botão em Configurações para garantir compatibilidade com as alterações do site
  • Exportar cookies frescos todos os meses para sites adultos que requerem autenticação
  • Usar a correspondência automática para poupar tempo na categorização de vídeos
  • Definir limites de download razoáveis (10-20) por verificação de origem para evitar esmagar o seu servidor
  • Use o recurso de horas ativa para agendar downloads durante os tempos de off-peak
  • Mantenha o PatrocínioBlock ativado para o YouTube melhorar a qualidade de conteúdo


Resolução de Problemas

yt-dlp Mostra "Não Instalado"

O que você vê: O painel de status do sistema mostra "Não Instalado" ou as páginas mostram um aviso de que o yt-dlp está faltando.

Como corrigi-lo:

  1. Ir para Configurações do menu superior
  2. Rolar para baixo para o Instruções de instalação secção
  3. Siga as instruções passo a passo para o seu tipo de servidor
  4. As instruções mostram dois métodos (pipx ou binário autônomo)
  5. Após a instalação, clique no Auto- Detecção botão
  6. O status deve mudar para "Pronto"

Nota:
Se você instalou o yt-dlp e ele ainda mostra "Não Instalado", seu usuário do servidor web pode não ter acesso a ele. Veja as instruções de link simbólico na página Configurações.

Downloads Continuar falhando com erro 403

O que você vê: Trabalhos na Fila mostram o status "Falhou", e pairando sobre o ícone de informação mostra "403 Proibido".

Causas e soluções possíveis:

Se for um site adulto:

  1. Ir para Gerenciador de cookies
  2. Adicione um perfil de cookies para esse site (consulte "Como baixar conteúdo restrito à idade" acima)
  3. Repetir a transferência

Se os cookies já forem adicionados:

  1. Your cookies may have expired
  2. Re-export fresh cookies from your browser
  3. Go to Cookie Manager and update the profile
  4. Retry the download

 

If it's a regular site:

  1. The site might be blocking your server's IP
  2. Try enabling a proxy in Settings
  3. Or wait a few hours and try again

 

Videos Not Appearing on My Site

What you see: The download shows "Completed" in the Queue, but you don't see the video on your website.

How to fix it:

  1. Go to Admin Panel > Videos > Video Management
  2. Look for the video in the list
  3. Check the Status column:

 

  • If it shows Pending, the video is waiting to be processed
  • If it shows Processing, conversion is happening (wait a few minutes)
  • If it shows Error, there was a problem with video processing

 

  1. Make sure both required background tasks are running on your server
  2. If you don't see the video at all in Video Management, check the download folder setting matches your video processor configuration

 

 

Warning:
There's a delay between download completion and frontend visibility. Small videos might appear in 5-10 minutes. Large videos can take 30+ minutes depending on your server speed.

 

What you see: After adding a cookie profile and clicking Test, it shows "Invalid" or "Age verification failed".

How to fix it:

  1. Make sure you were logged into the site when you exported cookies
  2. Re-export fresh cookies (they may have expired)
  3. Make sure you exported in Netscape format, not JSON
  4. Use the Validate Format button in Quick Add to check the format before saving
  5. Check that your account has age verification completed on that site

 

Downloads Are Very Slow

What you see: Download speeds shown in the Queue are much slower than expected.

Check:

  1. Go to Settings > Download tab
  2. Check if Rate Limit is set to something other than 0
  3. If it's set to a number, that's your speed cap in KB/s
  4. Set it to 0 for unlimited speed
  5. Also check if your server has bandwidth limitations
  6. Try reducing Max Concurrent Downloads if your connection is slow

 

Can't Find the Binary

What you see: Error messages about exec() being disabled or binary not found.

How to fix it:

  1. Contact your hosting provider or server administrator
  2. Ask them to enable the exec(), shellexec(), and procopen() PHP functions
  3. These functions must be removed from the disablefunctions list in php.ini

 

 

Error:
The download system cannot work without exec() enabled. This is a hard requirement and there is no workaround.

 

Duplicate Downloads

What you see: When you try to download a video, History shows it as "Duplicate" and it doesn't download again.

How to fix it:

  1. Go to History page
  2. Find the video you want to re-download
  3. Click the Redownload button
  4. You'll be redirected to Direct Download with the URL pre-filled
  5. Click Add to Download Queue

 

 

Note:
The system tracks every video you've downloaded to prevent duplicates. Use the Redownload feature if you intentionally want to download the same video again.

 

Videos Stuck at "Pending" in Queue

What you see: Jobs show "Pending" status for a long time and never start downloading.

Check:

  1. Make sure yt-dlp is installed (check System Status on Hub page)
  2. Check if you've reached the maximum concurrent downloads (default is 2)
  3. Wait for active downloads to finish
  4. Check that the download folder is writable

 


Page When to Use It
Video Management To see and manage all videos on your site, including downloaded ones
FTP Upload Alternative bulk upload method if you have video files already
Storage Servers Configure where processed videos are stored (CDN setup)
Video Processor Dashboard Monitor video conversion status and troubleshoot processing issues
Categories Set up categories that auto-matching can use
Models Add performers/models that auto-matching can detect

Installation Summary

If you're setting up the download system for the first time:

  1. Install yt-dlp - Go to Settings and follow the installation instructions
  2. Set up your first source - Use the Hub to add a YouTube channel or playlist
  3. Configure autopilot - Set it to check once daily during off-peak hours
  4. Test a direct download - Download a single video to make sure everything works
  5. Add cookies if needed - Set up authentication for adult sites
  6. Monitor for a few days - Check the Queue and History to ensure downloads are successful
  7. Adjust settings - Fine-tune quality, limits, and filters based on results

 

Tip:
Start simple with YouTube channels before moving to authenticated adult sites. This helps you learn the system without authentication complications.