Communitygithub.com

enregistreur-ecran-tiktok

Enregistre un écran authentique d'une courte vidéo et le vérifie image par image. Utilisez cette compétence pour capturer, enregistrer ou screener une URL vidéo, ou traiter un lot à partir d'un fichier de file d'attente. Elle gère l'intégralité du pipeline, du téléchargement à la sortie vérifiée, sur une machine Linux sans tête.

Qu'est-ce que enregistreur-ecran-tiktok ?

Cette compétence permet de capturer de manière fiable des enregistrements d'écran de vidéos TikTok (ou d'autres sources similaires) en automatisant un pipeline complet : téléchargement, transcodage, capture d'écran via Xvfb, découpage temporel, et vérification image par image à l'aide de `verify.py`. Contrairement à de simples vérifications de durée ou de taille de fichier, le script `pipeline.sh` détermine le succès uniquement par son code de sortie (0 pour succès, codes 3-15 pour divers échecs). Le pipeline est conçu pour fonctionner sur un serveur Linux sans tête (headless) utilisant Xvfb et PulseAudio, et peut traiter des lots à partir d'un fichier de file d'attente. Il évite les optimisations manuelles de ffmpeg, mpv ou Xvfb, et insiste sur le fait qu'aucun enregistrement ne doit être déclaré réussi sans vérification rigoureuse : une vidéo qui perd silencieusement sa dernière seconde aura toujours la bonne durée et le bon nombre d'images, seule la comparaison première/dernière image dans `verify.py` la détecte. Cette compétence est idéale pour les agents nécessitant une capture reproductible et vérifiée de vidéos courtes, avec une gestion explicite des erreurs et des recommandations pour le débogage en cas d'échec.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Pipeline de capture TikTok

Exécutez pipeline.sh. Ne réinventez pas les commandes ffmpeg, mpv ou Xvfb vous-même, et n'essayez pas de juger si un enregistrement a réussi à l'œil nu ou par la durée.

La règle unique

Ne rapportez jamais une capture comme réussie. Seul pipeline.sh le décide, via son code de sortie.

C'est important car un enregistrement qui perd silencieusement sa dernière seconde a toujours exactement la bonne durée et exactement le bon nombre d'images. Seule la comparaison première-image/dernière-image dans verify.py la détecte. Si vous êtes tenté de vérifier la durée ou la taille du fichier et de dire que c'est bon, c'est exactement l'échec que ce pipeline existe pour empêcher.

Exécuter un travail

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

Avec des cookies, lorsque la source nécessite une session :

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

Exécuter un lot

Lisez les URLs une par ligne depuis un fichier de file d'attente et bouclez. Exécutez en série sauf si vous avez vérifié le budget CPU au préalable — chaque travail nécessite environ 2 vCPU pour maintenir 30 ips sans perdre d'images, et chaque travail prend un numéro d'affichage et une instance PulseAudio dérivés de son propre PID, donc les exécutions concurrentes n'entrent pas en collision.

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

Codes de sortie

CodeSignificationQue faire
0VérifiéEnregistrez le chemin de sortie. Rien d'autre à faire.
3Dépendance manquanteArrêtez-vous et signalez. Non réessayable.
10Échec du téléchargementAttendu. Bloqué, privé ou supprimé. Journalisez et passez à autre chose.
11La source n'a pas d'audioJournalisez et passez à autre chose.
12Échec du transcodageJournalisez. Réessayez une fois, puis signalez.
13Échec de la captureVérifiez que Xvfb/pulseaudio sont installés et que la plage d'affichage est libre.
14Échec du découpageL'introduction n'a pas pu être mesurée ou validée. Signalez ; ne réessayez pas aveuglément.
15Échec de la vérificationLa sortie est à <sortie>.rejected. Signalez comme un défaut du pipeline.

Le code de sortie 10 est courant, pas un incident. Sur une IP de datacenter, c'est le résultat attendu pour une grande partie des URLs. Signalez-le comme un nombre, ne le réessayez pas en boucle.

En cas d'échecs répétés

Le code de sortie 14 ou 15 signifie que le pipeline lui-même est erroné, pas la vidéo. Lisez les mesures du manifest.json de l'exécution — first_frame_mae et last_frame_mae distinguent les deux cas :

  • Dernière image MAE élevée, première image MAE faible → l'introduction a été mesurée trop courte et la fin a été tronquée.
  • Les deux sont élevés → la capture est mal alignée ou l'écran ne s'est jamais mis à jour.

Signalez les nombres plutôt que d'ajuster les tolérances pour forcer un passage. Augmenter --match-threshold pour obtenir un résultat vert n'est pas une solution.

Skills associés