Communitygithub.com

playthegameoflife/tiktok-screen-recorder

Grava uma captura de tela genuína de um vídeo curto e a verifica com precisão de quadro. Use quando solicitado a capturar, gravar ou fazer screen recording de uma URL de vídeo, ou para processar um lote deles a partir de um arquivo de fila. Lida com todo o pipeline, desde o download até a saída verificada, em uma máquina Linux headless.

O que é tiktok-screen-recorder?

Esta habilidade implementa um pipeline completo para captura e verificação de vídeos do TikTok, projetado para ambientes headless Linux. Ela executa `pipeline.sh` que gerencia automaticamente o download, processamento, captura de tela com Xvfb e PulseAudio, e verificação frame-a-frame usando `verify.py`. A principal inovação é a verificação rigorosa: a saída só é considerada bem-sucedida se o script retornar código de saída 0, garantindo que gravações com perda silenciosa do último quadro sejam detectadas. A habilidade suporta operação em lote via arquivo de fila, com paralelismo seguro baseado em PID para evitar colisões de display. É útil para desenvolvedores e agentes de IA que precisam de um método confiável e automatizado para capturar e verificar vídeos curtos, especialmente em cenários onde a precisão temporal é crítica.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/playthegameoflife/tiktok-screen-recorder/tree/HEAD/hermes/skills/tiktok-capture

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Pipeline de captura do TikTok

Execute pipeline.sh. Não derive novamente os comandos ffmpeg, mpv ou Xvfb por conta própria, e não tente julgar se uma gravação foi bem-sucedida visualmente ou pela duração.

A única regra

Nunca relate uma captura como bem-sucedida. Apenas pipeline.sh decide isso, pelo código de saída.

Isso é importante porque uma gravação que perde silenciosamente seu último segundo ainda tem exatamente a duração correta e exatamente a contagem de quadros correta. Apenas a comparação do primeiro/último quadro em verify.py a detecta. Se você alguma vez se sentir tentado a verificar a duração ou o tamanho do arquivo e considerar como bom, esse é exatamente o tipo de falha que este pipeline existe para prevenir.

Executar um trabalho

OUT_DIR=/data/out ./pipeline.sh "https://www.tiktok.com/@user/video/123"

Com cookies, quando a fonte precisa de uma sessão:

OUT_DIR=/data/out COOKIES=/data/cookies.txt ./pipeline.sh "$URL"

Executar um lote

Leia URLs uma por linha de um arquivo de fila e faça um loop. Execute sequencialmente, a menos que você tenha verificado o orçamento de CPU primeiro — cada trabalho precisa de aproximadamente 2 vCPU para manter 30fps sem perder quadros, e cada trabalho usa um número de display e instância do PulseAudio derivados de seu próprio PID, portanto execuções concorrentes não colidem.

while read -r url; do
    [ -z "$url" ] && continue
    OUT_DIR=/data/out ./pipeline.sh "$url" || echo "FALHOU: $url"
done < queue.txt

Códigos de saída

CódigoSignificadoFaça isso
0VerificadoRegistre o caminho de saída. Nada mais a fazer.
3Dependência ausentePare e relate. Não tentar novamente.
10Download falhouEsperado. Bloqueado, privado ou removido. Registre e prossiga.
11Fonte sem áudioRegistre e prossiga.
12Transcrição falhouRegistre. Tente novamente uma vez, depois relate.
13Captura falhouVerifique se Xvfb/pulseaudio estão instalados e se o intervalo de displays está livre.
14Corte falhouA introdução não pôde ser medida ou validada. Relate; não tente novamente cegamente.
15Verificação falhouA saída está em <output>.rejected. Relate como um defeito do pipeline.

O código de saída 10 é rotineiro, não um incidente. Em um IP de datacenter, é o resultado esperado para uma grande parcela de URLs. Relate como uma contagem, não tente novamente em um loop.

Quando as coisas falham repetidamente

A saída 14 ou 15 significa que o pipeline em si está errado, não o vídeo. Leia as medições do manifest.json da execução — first_frame_mae e last_frame_mae distinguem os dois casos:

  • MAE do último quadro alto, MAE do primeiro quadro baixo → a introdução foi medida como curta e o final foi truncado.
  • ambos altos → a captura está desalinhada ou o display nunca atualizou.

Relate os números em vez de ajustar tolerâncias para forçar uma aprovação. Aumentar --match-threshold para obter um resultado verde não é uma correção.

Habilidades Relacionadas