Yt-dlp - ffmpeg - Intégrer sous-titres visible dans vidéo

ffmpeg -i Exemple.mp4 ^
-vf "subtitles=Exemple.srt" ^
-c:v libx264 -pix_fmt yuv420p -profile:v main -level 4.1 ^
-c:a copy ^
Exemple_subs.mp4

• Exemple.mp4 (Original) : Il a probablement été encodé par un appareil ou un logiciel grand public respectant déjà les normes strictes de diffusion (ex: YUV 420p, Profile Main/High). Votre décodeur TNT le lit donc de manière fluide.
• Exemple_subs.mp4 (Modifié) : Pour "incruster" (graver) les sous-titres dans l'image, FFmpeg est obligé de décoder puis de réencoder la piste vidéo (-c:v libx264). Sans précision de votre part, FFmpeg choisit des réglages modernes et optimisés pour les ordinateurs récents, que la puce électronique du décodeur TNT est incapable de décoder matériellement. [3]

1. Le format de pixels (-pix_fmt yuv420p) : Sans cela, FFmpeg réencode parfois dans un format de couleur supérieur (ex: YUV 444p). Les téléviseurs et décodeurs TNT affichent un écran noir ou une erreur de format s'ils reçoivent autre chose que du 420p. [1]
2. Le profil et le niveau (-profile:v main -level 4.1) : Les profils trop avancés demandent trop de puissance de calcul pour ces petits boîtiers. Restreindre au profil main résout 95 % des problèmes sur le matériel de salon. [1, 2]
3. Les guillemets autour du filtre (-vf "subtitles=Exemple.srt") : Si le nom de votre fichier SRT ou son chemin d'accès contient un jour un espace ou un caractère spécial, FFmpeg plantera immédiatement sans ces guillemets. [4]

La commande corrigée pour maîtriser le poids et préserver la compatibilité TNT

ffmpeg -i Exemple.mp4 ^
-vf "subtitles=Exemple.srt" ^
-c:v libx264 -pix_fmt yuv420p -profile:v main -level 4.1 -crf 28 -preset medium ^
-c:a copy ^
Exemple_subs.mp4

Les deux méthodes pour contrôler précisément la taille du fichier

Methode 1 : Le mode CRF (Recommandé)

Méthode 2 : Le ciblage par Bitrate (Débit fixe)

yt-dlp "URL_YOUTUBE" --write-subs --sub-format srt --ffmpeg-location "C:cheminversffmpeg.exe" --exec "ffmpeg -i {} -vf "subtitles=%(requested_subtitles.fr.filepath)s" -c:v libx264 -pix_fmt yuv420p -profile:v main -level 4.1 -crf 28 -preset medium -c:a copy "%(title)s_subs.mp4""

• --write-subs --sub-format srt : Demande à yt-dlp de télécharger le fichier de sous-titres au format .srt.
• --ffmpeg-location : Indique à yt-dlp où se trouve votre fichier ffmpeg.exe (optionnel si FFmpeg est déjà configuré dans les variables d'environnement de votre système).
• --exec "..." : Exécute la commande située entre guillemets immédiatement après le téléchargement.
• {} : Ce symbole est automatiquement remplacé par le nom du fichier vidéo que yt-dlp vient de télécharger.
• %(requested_subtitles.fr.filepath)s : Ce code dynamique transmet automatiquement à FFmpeg le chemin exact du fichier sous-titres téléchargé (ici l'exemple cible le français .fr, remplacez par la langue voulue si nécessaire).
• " : Les guillemets internes sont précédés d'un antislash pour que Windows comprenne qu'ils font partie de la sous-commande FFmpeg.

// download.js
const url = "URL_YOUTUBE";

// 1. Étape yt-dlp
const ytdlp = new Deno.Command("yt-dlp", {
  args: [url, "--write-subs", "--sub-format", "srt", "-o", "Exemple.%(ext)s"],
});
await ytdlp.output();

// 2. Étape FFmpeg
const ffmpeg = new Deno.Command("ffmpeg", {
  args: [
    "-i", "Exemple.mp4",
    "-vf", "subtitles=Exemple.fr.srt",
    "-c:v", "libx264", "-pix_fmt", "yuv420p", "-profile:v", "main", "-level", "4.1", "-crf", "28", "-preset", "medium",
    "-c:a", "copy",
    "Exemple_subs.mp4"
  ],
});
await ffmpeg.output();
console.log("Vidéo TNT prête !");

yt-dlp "https://www.youtube.com/watch?v=mYRlGKZNjAw" --write-auto-subs --sub-langs fr --sub-format srt --ffmpeg-location "ffmpeg.exe" --exec "ffmpeg -i {} -vf "subtitles=%(requested_subtitles.fr.filepath)s" -c:v libx264 -pix_fmt yuv420p -profile:v main -level 4.1 -crf 28 -preset medium -c:a copy video_tnt.mp4"

yt-dlp "https://www.youtube.com/watch?v=mYRlGKZNjAw" --write-auto-subs --sub-langs fr --sub-format srt --ffmpeg-location "ffmpeg.exe" --exec "ffmpeg -i {} -vf "subtitles=%(requested_subtitles.fr.filepath)s" -c:v libx264 -pix_fmt yuv420p -profile:v main -level 4.1 -crf 28 -preset medium -c:a copy "%(title)s_subs.mp4""

ffmpeg -i Exemple.mp4 ^
-vf "subtitles=Exemple.srt" ^
-c:v libx264 -pix_fmt yuv420p -profile:v main -level 4.1 -crf 28 -preset medium ^
-c:a libmp3lame -ar 44100 -ac 2 ^
Exemple_subs.mp4

• -c:a libmp3lame : Remplace le copier-coller (copy) par un réencodage propre de l'audio au format MP3 standard.
• -ar 44100 : Force la fréquence d'échantillonnage à 44.1 kHz, la norme de compatibilité la plus sûre.
• -ac 2 : Force le son en Stéréo (2 canaux). Si la vidéo d'origine possédait une piste en son multicanal 5.1, le décodeur TNT pouvait saturer et rejeter le fichier.

La commande à utiliser pour tester le format AAC valide

ffmpeg -i Exemple.mp4 ^
-vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2,subtitles=Exemple.srt,fps=30" ^
-c:v libx264 -pix_fmt yuv420p -profile:v main -level 4.1 -crf 28 -preset medium -bf 2 -vtag avc1 ^
-c:a aac -b:a 128k -ar 48000 ^
-movflags +faststart ^
Exemple_subs.mp4

Ce que cette commande sécurise en plus :

Si cela ne fonctionne toujours pas (Le test ultime en 720p)

ffmpeg -i Exemple.mp4 ^
-vf "scale=1280:720:force_original_aspect_ratio=decrease,pad=1280:720:(ow-iw)/2:(oh-ih)/2,subtitles=Exemple.srt,fps=30" ^
-c:v libx264 -pix_fmt yuv420p -profile:v main -level 4.1 -crf 28 -preset medium -bf 2 -vtag avc1 ^
-c:a aac -b:a 128k -ar 48000 ^
-movflags +faststart ^
Exemple_subs.mp4

1. Verrouiller la cadence à 25 ou 30 images par seconde (YouTube fournit souvent du 50 ou 60 fps que l'AMTC rejette).
2. Ajouter l'option d'indexation rapide (-movflags +faststart) pour que la puce lise l'en-tête du fichier dès le début de la clé USB.

ffmpeg -i Exemple.mp4 ^
-vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2,subtitles=Exemple.srt,fps=25" ^
-c:v libx264 -pix_fmt yuv420p -profile:v main -level 4.0 -crf 26 -preset medium ^
-c:a aac -b:a 128k -ar 48000 ^
-movflags +faststart ^
Exemple_subs.mp4

• fps=25 : Calque la fluidité sur la norme de diffusion TV française (PAL / 25 images par seconde). Cela soulage instantanément le processeur de votre boîtier AMTC.
• -movflags +faststart : Déplace les index de la vidéo (les métadonnées) au tout début du fichier .mp4. Sans cela, l'enregistreur TNT cherche les informations à la fin du fichier, plante sur la clé USB et affiche "Format non supporté".
• -level 4.0 : Descend d'un cran la complexité du décodage matériel (la commande précédente était en 4.1) pour correspondre exactement aux puces économiques utilisées par AMTC. [1]
• -c:a aac -b:a 128k -ar 48000 : Encode proprement l'audio en AAC standard stéréo échantillonné à 48 kHz, qui est le format natif de la TNT HD en France.

1. Le format audio (AAC-LC vs AAC-MAIN) : FFmpeg utilise par défaut le profil AAC-LC, mais selon la version, il peut insérer des données d'en-tête (ADTS) que les puces de salon bas de gamme ne gèrent pas.
2. L'organisation des paquets (Muxing) : L'option -movflags +faststart déplace l'index (moov atom) au début du fichier. C'est parfait pour le streaming web, mais cela perturbe souvent les vieux lecteurs multimédias matériels qui s'attendent à le trouver à la fin.
3. Le conteneur MP4 : Ces appareils préfèrent souvent le format MKV ou AVI pour la lecture de fichiers externes, ou un codec vidéo strictement limité en encodage (comme le format Xvid ou un H.264 très basique sans options avancées de compression).

yt-dlp --js-runtimes deno ^
 --extractor-args youtube:player_client=web_embedded ^
 -f bv*[vcodec*=avc1]+ba[acodec*=mp4a]/b[ext=mp4] ^
 --write-subs --write-auto-subs --sub-langs fr ^
 --embed-subs --convert-subs srt ^
 --exec "ffmpeg -i {} -vf subtitles={}:force_style='FontSize=12' -c:v libx264 -pix_fmt yuv420p -profile:v main -level 4.0 -crf 26 -c:a copy -merge-output-format mp4 {}.subs.mp4" ^
 https://youtu.be/7b1yIgBorSc

ffmpeg -i Exemple.mp4 ^
 -vf scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2,subtitles=Exemple.srt,fps=25 ^
 -c:v libx264 -pix_fmt yuv420p -profile:v main -level 4.0 -crf 26 -preset medium ^
 -c:a copy ^
 Exemple_subs.mp4

• -c:a copy : On ne touche pas à l'audio. On garde exactement la piste récupérée par yt-dlp qui, elle, plaisait à votre enregistreur.
• Suppression de -movflags +faststart : L'index reste à la fin du fichier, une structure standard pour les puces TNT de salon.