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
| Code | Signification | Que faire |
|---|---|---|
| 0 | Vérifié | Enregistrez le chemin de sortie. Rien d'autre à faire. |
| 3 | Dépendance manquante | Arrêtez-vous et signalez. Non réessayable. |
| 10 | Échec du téléchargement | Attendu. Bloqué, privé ou supprimé. Journalisez et passez à autre chose. |
| 11 | La source n'a pas d'audio | Journalisez et passez à autre chose. |
| 12 | Échec du transcodage | Journalisez. Réessayez une fois, puis signalez. |
| 13 | Échec de la capture | Vérifiez que Xvfb/pulseaudio sont installés et que la plage d'affichage est libre. |
| 14 | Échec du découpage | L'introduction n'a pas pu être mesurée ou validée. Signalez ; ne réessayez pas aveuglément. |
| 15 | Échec de la vérification | La 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.