Utiliser gallery-dl avec Twitter / X
Ce guide explique comment tester une publication ou un profil X, utiliser des cookies locaux, classer les médias, éviter les doublons et résoudre les erreurs d'authentification ou de limitation.
Commencez par une URL x.com entre guillemets avec --simulate. Si l'extracteur exige une authentification, utilisez --cookies-from-browser avec votre propre profil. Après un petit test réussi, ajoutez une archive stable avant de traiter un compte entier.
Tester une URL Twitter avant le téléchargement
gallery-dl reconnaît plusieurs types d'URL Twitter / X : publication unique, onglet /media, fil d'un utilisateur, mentions J'aime, favoris, listes, recherches et autres pages prises en charge. Pour un premier essai, choisissez une publication publique ou l'onglet média d'un compte. Copiez l'URL canonique x.com, placez-la entre guillemets et simulez l'extraction avant d'écrire des fichiers.
La simulation indique si votre version est assez récente, si l'URL active le bon extracteur, si une connexion est nécessaire et quels fichiers seraient retenus. Un fil peut mélanger republications, réponses, citations, vidéos et médias répétés. Une URL reconnue ne prouve donc pas encore que la sélection par défaut correspond à votre objectif.
gallery-dl --simulate "https://x.com/UTILISATEUR/status/ID_PUBLICATION"gallery-dl --simulate "https://x.com/UTILISATEUR/media"gallery-dl -K "https://x.com/UTILISATEUR/status/ID_PUBLICATION"UTILISATEUR et ID_PUBLICATION doivent correspondre à une URL réelle que vous êtes autorisé à consulter.
Créer un téléchargement Twitter reproductible
Après une simulation réussie, choisissez un dossier prévisible et ajoutez une archive de téléchargement. Elle enregistre les identifiants des fichiers terminés et les ignore lors des exécutions suivantes, même si les noms changent. Limitez le premier téléchargement réel, inspectez les chemins et les formats, puis augmentez progressivement la portée.
L'extracteur Twitter peut inclure ou exclure réponses, republications, citations, cartes, articles, aperçus, messages textuels et vidéos. Les valeurs par défaut peuvent évoluer. Utilisez -K avant de concevoir des noms ou filtres, conservez une archive stable pour la tâche récurrente et ne publiez jamais les chemins de profil ou informations de session.
gallery-dl --cookies-from-browser firefox --range "1-25" --download-archive "twitter.sqlite3" "https://x.com/UTILISATEUR/media"gallery-dl --destination "D:/Media/X" --download-archive "twitter.sqlite3" "https://x.com/UTILISATEUR/media"gallery-dl --write-metadata --download-archive "twitter.sqlite3" "https://x.com/UTILISATEUR/media"| Objectif | Option | Utilité |
|---|---|---|
| Tester sans fichier | --simulate | Vérifie l'extracteur, l'accès et la sélection |
| Limiter le premier lot | --range 1-25 | Facilite la vérification |
| Éviter les doublons | --download-archive FICHIER | Mémorise les identifiants réussis |
| Utiliser la session locale | --cookies-from-browser NAVIGATEUR | Lit un profil sous votre contrôle |
| Inspecter les champs | -K URL | Montre les données de noms et filtres |
Configurer gallery-dl pour Twitter / X
Ne déplacez les options dans la configuration qu'après avoir validé la commande. L'exemple officiel expose notamment include, replies, retweets, quoted, videos, la taille, les tentatives API et la gestion des limites. Un petit bloc revu est plus sûr qu'une copie complète dont on ne connaît plus les effets.
L'exemple conserve les vidéos, exclut réponses, republications et citations, attend en cas de limitation et utilise une archive stable. Gardez éventuellement le choix des cookies dans la commande si plusieurs machines utilisent des profils différents. Vérifiez le JSON : commentaires, virgules finales et antislashs Windows non échappés le rendent invalide.
{
"extractor": {
"twitter": {
"replies": false,
"retweets": false,
"quoted": false,
"videos": true,
"ratelimit": "wait",
"archive": "D:/gallery-dl/twitter.sqlite3"
}
}
}gallery-dl --config-ignore --simulate "https://x.com/UTILISATEUR/media"gallery-dl --config-statusDépanner les erreurs gallery-dl sur Twitter
Distinguez authentification, limitation, résultat vide et doublons. AuthRequired indique généralement des cookies absents ou expirés. HTTP 429 signifie qu'il faut attendre plutôt que relancer agressivement. Un résultat vide peut venir d'une mauvaise URL, d'un contenu inaccessible, d'un filtre restrictif ou d'une archive qui contient déjà les identifiants.
Comparez une simulation propre avec --config-ignore à la même URL avec vos réglages. Ajoutez cookies, plage, archive et filtres séparément. Mettez gallery-dl à jour par le canal d'installation d'origine, contrôlez la version et consultez les problèmes du projet avant de croire qu'une répétition rapide corrigera une modification de X.
| Symptôme | Premier contrôle | Étape sûre |
|---|---|---|
| Cookies authentifiés requis | Ouvrir la cible dans le profil choisi | Renouveler la connexion normale et simuler |
| HTTP 429 | Vérifier ratelimit et tentatives | Attendre, sans boucle parallèle |
| Aucun fichier | Utiliser --config-ignore sans filtre | Vérifier URL, accès et extracteur |
| Tout est ignoré | Contrôler l'archive | Tester une archive temporaire seulement pour diagnostiquer |
| Réponses inattendues | Relire les réglages Twitter | Définir replies, retweets et quoted |
Connaître les limites avant un téléchargement massif
gallery-dl est un téléchargeur local, pas un système d'autorisation. Ne téléchargez que les médias auxquels vous avez légalement accès, respectez la vie privée, les droits d'auteur, les règles applicables et la loi. Ne partagez jamais cookies, jetons, archives privées ou données personnelles téléchargées.
Le 30 juillet 2026, ce site a vérifié gallery-dl 1.32.8 dans les métadonnées officielles PyPI et confirmé que les fichiers Windows et Linux officiels de Codeberg répondent en HTTP 200 avec les noms et tailles attendus. Le comportement de X peut changer : revérifiez toujours la version et la documentation lorsqu'une commande cesse de fonctionner.
FAQ gallery-dl pour Twitter / X
gallery-dl fonctionne-t-il avec Twitter / X ?
Oui. L'extracteur actuel reconnaît publications, médias, fils, mentions J'aime, favoris, listes, recherches et autres URL prises en charge. Simulez l'URL exacte.
Pourquoi des cookies authentifiés sont-ils nécessaires ?
X limite l'accès anonyme. Connectez-vous normalement dans votre profil puis utilisez --cookies-from-browser avec ce même profil.
Comment télécharger seulement les médias d'un compte ?
Utilisez son URL /media, simulez-la et commencez par une petite plage avant d'élargir.
Comment éviter les doublons ?
Conservez une archive stable avec --download-archive ; gallery-dl mémorise les identifiants réussis.
Que faire en cas de limitation ?
Laissez ratelimit attendre, réduisez les requêtes et évitez les relances parallèles. Une mise à jour peut être nécessaire.
Puis-je partager ma configuration ?
Seulement après avoir supprimé chemins de cookies, profils, comptes, archives privées, URL et jetons.