Générateur de commandes yt-dlp pour X (Twitter)

Composez une commande yt-dlp pour une vidéo sur X, avec des noms de fichiers prévisibles et les options qu'exige le contenu sensible.

URL de la vidéo, de la playlist ou de la chaîne

Facultatif. Laissez vide et la commande se terminera par URL, à compléter vous-même.

Votre commande

yt-dlp --merge-output-format mp4 --no-playlist -o '%(uploader_id)s - %(id)s.%(ext)s' https://x.com/user/status/1234567890

Bases

Ce que vous voulez

Vidéo Audio seul

Audio seul extrait la piste sonore et jette la vidéo.

Vidéo et qualité

Qualité maximale -f

Plafonne la hauteur. yt-dlp choisit malgré tout la meilleure piste à ce niveau ou en dessous.

Container --merge-output-format nécessite ffmpeg

Le type de fichier dans lequel les pistes vidéo et audio séparées sont fusionnées.

Options avancées (3)

format selector personnalisé -f

Remplace la liste de qualité. Pour ceux qui connaissent déjà la syntaxe des formats.

Remux vers --remux-video nécessite ffmpeg

Réemballe les pistes sans réencoder. Rapide et sans perte.

Réencoder vers --recode-video nécessite ffmpeg

Réencode la vidéo. Lent et avec perte — seulement si remux ne suffit pas.

Audio

Format audio --audio-format nécessite ffmpeg

Le fichier vers lequel l'audio est converti.

Qualité audio --audio-quality nécessite ffmpeg

Le VBR offre le meilleur rapport taille/qualité ; un bitrate fixe est plus prévisible.

Sous-titres

L'incrustation les place dans la vidéo ; l'enregistrement écrit un .srt séparé à côté.

Langues des sous-titres --sub-langs

Séparées par des virgules. Écrivez all pour toutes les langues disponibles.

Sous-titres automatiques --write-auto-subs Inclut les sous-titres générés par machine quand il n'y en a pas d'humains.

Playlists et chaînes

Traitement des playlists

Que faire quand l'URL appartient à la fois à une vidéo et à une playlist.

Quels éléments -I

Les plages et les listes fonctionnent, par exemple 1-10,15 ou -5::2 pour un élément sur deux depuis la fin.

Options avancées (1)

Fichier de suivi --download-archive

Note ce qui a déjà été téléchargé pour qu'une nouvelle exécution le saute. C'est ainsi qu'on garde une chaîne à jour.

Extraits et chapitres

Options avancées (2)

Ne télécharger qu'un extrait --download-sections nécessite ffmpeg

Une plage horaire comme *00:01:30-00:03:00, ou un nom de chapitre. L'astérisque de tête indique un horodatage.

Découper par chapitres --split-chapters nécessite ffmpeg Écrit un fichier par chapitre au lieu d'un seul long.

Métadonnées et pochette

Incruster la miniature --embed-thumbnail nécessite ffmpeg Utilise la miniature de la vidéo comme pochette.

Incruster les métadonnées --embed-metadata nécessite ffmpeg Écrit le titre, l'auteur et la date dans le fichier lui-même.

Incruster les chapitres --embed-chapters nécessite ffmpeg Ajoute des repères de chapitre entre lesquels votre lecteur peut sauter.

Options avancées (3)

Enregistrer la miniature --write-thumbnail Écrit l'image de pochette à côté de la vidéo.

Enregistrer la description --write-description Écrit la description dans un fichier .description.

Enregistrer les métadonnées en JSON --write-info-json Écrit tout ce que yt-dlp sait de la vidéo dans un fichier .info.json.

SponsorBlock

Supprimer des segments --sponsorblock-remove nécessite ffmpeg

Coupe du fichier les segments signalés par la communauté, d'après les données SponsorBlock.

Options avancées (1)

Marquer les segments en chapitres --sponsorblock-mark

Conserve les segments mais les signale, pour que vous les sautiez vous-même.

Fichiers et dossiers

Modèle de nom de fichier -o

Les noms de champs s'écrivent dans %(...)s. Les barres obliques créent des dossiers.

Noms de fichiers sûrs (ASCII uniquement) --restrict-filenames Retire les accents, les espaces et tout caractère qu'un système de fichiers pointilleux pourrait refuser.

Écraser les fichiers existants --force-overwrites Remplace les fichiers déjà présents.

Reprendre les téléchargements interrompus -c Repart de là où le téléchargement s'est arrêté.

Options avancées (4)

Dossier de téléchargement -P

Où les fichiers sont écrits. Combiné au modèle ci-dessus, cela crée des sous-dossiers.

Noms compatibles Windows --windows-filenames Retire les caractères que Windows refuse, même si vous travaillez sur un autre système.

Raccourcir les noms à --trim-filenames

Longueur maximale du nom de fichier, en caractères.

Ne jamais écraser -w Saute tout ce qui est déjà téléchargé.

Filtres

Options avancées (5)

Publié après --dateafter

AAAAMMJJ, ou une date relative comme now-1month.

Publié avant --datebefore

AAAAMMJJ, ou une date relative.

Taille minimale --min-filesize

Saute tout ce qui est plus petit. Accepte 5M, 500K et analogues.

Taille maximale --max-filesize

Saute tout ce qui est plus grand.

Arrêter après --max-downloads

Nombre de fichiers à télécharger avant de s'arrêter.

Réseau

Limite de débit -r

Par exemple 2M ou 500K. Utile quand vous avez besoin du reste de la bande passante.

Options avancées (5)

fragments en parallèle -N

Accélère les flux fragmentés. Quatre est un point de départ raisonnable.

Nouvelles tentatives -R

Combien de fois réessayer une partie en échec. infinite est accepté.

Proxy --proxy

URL d'un proxy HTTP, HTTPS ou SOCKS.

Contourner le blocage géographique --geo-bypass Feint l'origine de la requête. Fonctionne sur certains sites, pas sur tous.

Se faire passer pour un navigateur --impersonate

Fait ressembler les requêtes à celles d'un vrai navigateur. C'est le remède habituel à un 403 soudain.

Connexion et cookies

Cookies depuis le navigateur --cookies-from-browser

Lit directement votre session connectée. Nécessaire pour le contenu privé, restreint par âge ou réservé aux membres.

Options avancées (1)

Fichier cookies --cookies

Un cookies.txt au format Netscape exporté depuis votre navigateur.

Direct

Options avancées (2)

Enregistrer depuis le début --live-from-start Démarre un direct au début plutôt qu'à l'instant présent.

Attendre le direct --wait-for-video

Interroge jusqu'à ce qu'un direct programmé commence. MIN-MAX est l'intervalle entre les vérifications, en secondes.

Contournements

Options avancées (3)

User agent --user-agent obsolète

Obsolète au profit de --add-headers. Conservé parce que beaucoup de vieux tutoriels s'en servent encore.

Referer --referer obsolète

Obsolète au profit de --add-headers.

Arguments d'extractor --extractor-args

Options propres à un site, par exemple youtube:player_client=web.

Sortie et débogage

Lister les formats seulement -F Affiche les formats disponibles et s'arrête sans télécharger.

Options avancées (2)

Continuer malgré les erreurs -i Saute les éléments en échec au lieu de s'arrêter. Indispensable sur les grandes playlists.

Simuler -s Fait tout sauf écrire le fichier.

Réinitialiser

Les options qui comptent ici

Qualité maximale -f Plafonne la hauteur. yt-dlp choisit malgré tout la meilleure piste à ce niveau ou en dessous.
Cookies depuis le navigateur --cookies-from-browser Lit directement votre session connectée. Nécessaire pour le contenu privé, restreint par âge ou réservé aux membres.
Modèle de nom de fichier -o Les noms de champs s'écrivent dans %(...)s. Les barres obliques créent des dossiers.

Vous n’avez pas encore yt-dlp ?

C’est un programme gratuit qui s’exécute sur votre propre ordinateur. L’installation prend environ une minute.

À savoir sur X

Les adresses x.com et twitter.com fonctionnent toutes les deux. Ce qu'on appelle GIF sur X est en réalité une courte vidéo MP4 : cela se télécharge comme n'importe quelle vidéo ; convertissez ensuite s'il vous faut un vrai GIF.

Les publications au contenu sensible exigent une session connectée avec le réglage correspondant activé. Le modèle par défaut nomme les fichiers par auteur et id de publication, ce qui garde navigable un dossier rempli de ces fichiers.

X a changé plusieurs fois la surface de son API, et la conséquence pratique est que les correctifs d'extracteurs arrivent dans les mises à jour de yt-dlp sous quelques jours — une installation de plus de quelques semaines est l'endroit où vivent réellement la plupart des rapports « X est cassé ». Mettez à jour avant de déboguer : yt-dlp -U. L'accès invité va et vient ; quand il est retiré, une session connectée avec cookies est la voie qui marche, et c'est aussi la seule voie vers les médias sensibles.

Les fils et les publications-citations sont là où les URL deviennent confuses. Un tweet contenant une vidéo l'intègre ; la même vidéo sur l'onglet Médias du profil est un élément séparé. Pour un compte entier, l'URL de l'onglet Médias récupère tout ce qui a été publié avec des médias, paginé, et le fichier de suivi plus « continuer malgré les erreurs » gère les publications supprimées qu'un compte actif accumule inévitablement. Les téléchargements par URL de recherche sont volontairement non pris en charge ici : les résultats dérivent entre les requêtes, et un suivi sur une recherche mouvante n'a aucun sens.

X sert la vidéo en fragments HLS avec un repli MP4 dans la plupart des cas, les fusions sont donc fréquentes et ffmpeg est la dépendance à vérifier en premier. Les publications « GIF » sont l'exception à connaître : elles arrivent en MP4 comme tout le reste, et la conversion en un vrai GIF ensuite est un travail pour ffmpeg, pas pour yt-dlp — un WebM bouclé correspond d'ordinaire mieux à ce que l'expéditeur voulait dire.

Les publications restreintes par âge et sensibles sont le mur dur : le réglage vit dans le compte, pas dans la commande. Connectez-vous une fois par le navigateur, activez le réglage des médias sensibles, passez les cookies, et ça marche — aucun contournement sans cookies n'existe, parce que X vérifie la session côté serveur. Les publications supprimées se comportent comme partout : parti est parti, et les miroirs qui gardaient des copies ont fermé il y a des années.

Questions fréquentes

› Pourquoi une publication restreinte par âge échoue-t-elle sur X ?

Le contenu sensible exige une session connectée. Utilisez --cookies-from-browser avec un compte où ce réglage est activé.

› Comment télécharger un GIF depuis X ?

Ce sont des vidéos MP4, pas des GIF, et elles se téléchargent comme n'importe quelle vidéo. Convertissez ensuite s'il vous faut un vrai GIF.

› Peut-on choisir la qualité vidéo sur X ?

Oui. X publie plusieurs versions : plafonnez la hauteur via le choix de qualité, ou listez-les d'abord avec -F.