Importando vídeos

O TubePress pode preencher sua biblioteca de várias formas — desde adicionar um único clipe manualmente até importar centenas de milhares de vídeos prontos da nuvem. Esta página apresenta o importador integrado e indica onde encontrar cada outro método.

Qualquer que seja o método escolhido, o resultado é o mesmo: vídeos comuns que você pode editar, organizar, moderar e publicar como qualquer outro. Escolha o que melhor se adapta à quantidade de conteúdo que você tem e se prefere uma carga única ou algo que se atualiza continuamente.

Formas de adicionar conteúdo ao TubePress

Não existe uma única forma "certa" de adicionar vídeos — cada método é adequado a uma escala e fluxo de trabalho diferente. Use a tabela abaixo para escolher e siga o link para os detalhes.

Importando um único vídeo

O TubePress não possui um importador separado para "um único vídeo" — para adicionar um único vídeo, use a tela Vídeos em /admin/videos e escolha Adicionar Vídeo. Há duas formas de fornecer a mídia:

• Upload manual — faça o upload de um arquivo de vídeo que você mesmo hospeda.
• Importação por URL única — cole um código de incorporação <iframe> ou uma URL de vídeo direta para incorporar um clipe hospedado em outro lugar.

Preencha o título e a miniatura, vincule categorias, tags ou performers, e salve como rascunho ou publique imediatamente. Nenhum dos dois métodos utiliza créditos.

Importação em massa

A importação em massa fica na aba Upload de Arquivo em /admin/import. Ela aceita um único arquivo CSV ou JSON — não uma lista de URLs coladas — e transforma cada linha ou objeto em um vídeo.

• CSV deve ter uma linha de cabeçalho e usar vírgulas como separadores.
• JSON deve ser um array de objetos.

Arraste o arquivo para a zona de upload (ou clique para navegar) e o TubePress lê as colunas e exibe uma pré-visualização. Um CSV mínimo tem esta aparência:

title,embed_code,thumbnail,duration,tags
My clip,https://ex.com/v/123.mp4,https://ex.com/t.jpg,612,"solo,hd"

Em seguida, você mapeia suas colunas para os campos do TubePress arrastando-as para o lugar. Os campos reconhecidos pelo importador incluem:

Antes de começar, defina como os duplicados são tratados (pular ou atualizar, correspondidos por video_id), se deve baixar miniaturas para que sejam servidas a partir do seu armazenamento, e qualquer reescrita ou tradução opcional por IA.

Como funciona a fila de importação

Para arquivos além de um tamanho pequeno, escolha Iniciar em segundo plano. O TubePress cria um trabalho e o passa para o processador de importação, que processa suas linhas mesmo após você fechar a aba. Nenhum crontab do sistema é necessário — ele é executado no pseudo-cron integrado.

O processador foi projetado para ser seguro e resiliente:

• Em blocos. As linhas são importadas aos poucos para que um worker web nunca fique travado; uma velocidade de importação ajustável controla quantas por bloco.
• Assíncrono. O pseudo-cron pega o trabalho conforme o site recebe tráfego, e a página de importação o estimula enquanto está aberta.
• Autorrecuperável. Um trabalho que trava — por exemplo, uma reinicialização do servidor durante a execução — é recolocado na fila automaticamente após cerca de cinco minutos e continua de onde parou.
• Com deduplicação. Linhas com um video_id conhecido são ignoradas ou atualizadas em vez de duplicadas.
• Tolerante a erros. Uma linha incorreta é registrada (os primeiros erros por bloco são amostrados) e o trabalho continua.

Monitorando o progresso da importação

Abra /admin/import e observe a Fila de Importação. Cada trabalho ativo exibe contagens em tempo real — importados, ignorados, erros e processados do total — atualizadas a cada poucos segundos.

Daqui você pode pausar, retomar, cancelar ou excluir um trabalho. Os trabalhos das últimas 24 horas permanecem listados para que você possa revisar o que aconteceu, incluindo amostras de mensagens de erro para linhas que falharam.

Dicas e limites

• Somente arquivos .csv e .json são aceitos; outros formatos são rejeitados imediatamente.
• O mínimo prático por linha é um título, um código de incorporação e uma miniatura.
• O tamanho do upload é limitado pelos valores upload_max_filesize e post_max_size do seu servidor. Divida arquivos muito grandes ou use um trabalho em segundo plano.
• Mapeie um video_id estável para que a re-execução de um arquivo atualize em vez de duplicar.
• Ative Baixar miniaturas para auto-hospedar imagens em vez de hotlinking da fonte.
• A reescrita e tradução por IA consomem créditos e requerem uma conta tubepress.io vinculada; se o saldo estiver muito baixo, o trabalho para com uma mensagem clara.

Próximos passos