MÉTHODE TWITTER / X

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.

Profils et publicationsCookies locauxArchive anti-doublons
Schéma éditorial de médias sociaux traités par un terminal gallery-dl vers des dossiers locaux
Illustration : gallery-dl fonctionne localement avec l'URL et la session que vous choisissez.
Réponse rapide

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.

VÉRIFIER LA CIBLE

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.

Tester une publication
gallery-dl --simulate "https://x.com/UTILISATEUR/status/ID_PUBLICATION"
Tester les médias d'un compte
gallery-dl --simulate "https://x.com/UTILISATEUR/media"
Afficher les métadonnées
gallery-dl -K "https://x.com/UTILISATEUR/status/ID_PUBLICATION"
Remplacez les valeurs

UTILISATEUR et ID_PUBLICATION doivent correspondre à une URL réelle que vous êtes autorisé à consulter.

AUTHENTIFICATION LOCALE

Utiliser les cookies du navigateur lorsque X exige une connexion

Twitter limite souvent l'accès anonyme aux fils. Si gallery-dl demande des cookies authentifiés, connectez-vous normalement dans un profil de navigateur que vous contrôlez, vérifiez que la page cible y est visible, puis indiquez ce profil local à gallery-dl. Cette méthode lit la base de cookies sur votre appareil et ne demande jamais de coller les valeurs dans ce site.

Fermez complètement le navigateur si sa base de cookies est verrouillée et sélectionnez le profil qui contient réellement la session X. Une session expirée, une vérification supplémentaire, un compte privé, une restriction d'âge ou des droits particuliers peuvent encore bloquer l'accès. Les cookies reproduisent seulement les autorisations déjà accordées à votre compte.

Flux éditorial d'un profil social via des cookies et gallery-dl vers des dossiers locaux
Illustration : la session reste locale pendant que gallery-dl enregistre les médias sélectionnés.
Session Firefox
gallery-dl --cookies-from-browser firefox --simulate "https://x.com/UTILISATEUR/media"
Session Chrome
gallery-dl --cookies-from-browser chrome --simulate "https://x.com/UTILISATEUR/media"
Session Edge
gallery-dl --cookies-from-browser edge --simulate "https://x.com/UTILISATEUR/media"
MAÎTRISER L'EXÉCUTION

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.

Premier lot limité
gallery-dl --cookies-from-browser firefox --range "1-25" --download-archive "twitter.sqlite3" "https://x.com/UTILISATEUR/media"
Choisir un dossier racine
gallery-dl --destination "D:/Media/X" --download-archive "twitter.sqlite3" "https://x.com/UTILISATEUR/media"
Écrire les métadonnées
gallery-dl --write-metadata --download-archive "twitter.sqlite3" "https://x.com/UTILISATEUR/media"
ObjectifOptionUtilité
Tester sans fichier--simulateVérifie l'extracteur, l'accès et la sélection
Limiter le premier lot--range 1-25Facilite la vérification
Éviter les doublons--download-archive FICHIERMémorise les identifiants réussis
Utiliser la session locale--cookies-from-browser NAVIGATEURLit un profil sous votre contrôle
Inspecter les champs-K URLMontre les données de noms et filtres
CONSERVER LES RÉGLAGES STABLES

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.

Configuration Twitter ciblée
{
  "extractor": {
    "twitter": {
      "replies": false,
      "retweets": false,
      "quoted": false,
      "videos": true,
      "ratelimit": "wait",
      "archive": "D:/gallery-dl/twitter.sqlite3"
    }
  }
}
Tester sans configuration
gallery-dl --config-ignore --simulate "https://x.com/UTILISATEUR/media"
Contrôler la configuration active
gallery-dl --config-status
ISOLER LA PANNE

Dé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.

Schéma de dépannage pour cookies expirés, limitation et contrôle des doublons
Illustration : séparez les problèmes d'accès, de rythme et d'archive avant de modifier la commande.
SymptômePremier contrôleÉtape sûre
Cookies authentifiés requisOuvrir la cible dans le profil choisiRenouveler la connexion normale et simuler
HTTP 429Vérifier ratelimit et tentativesAttendre, sans boucle parallèle
Aucun fichierUtiliser --config-ignore sans filtreVérifier URL, accès et extracteur
Tout est ignoréContrôler l'archiveTester une archive temporaire seulement pour diagnostiquer
Réponses inattenduesRelire les réglages TwitterDéfinir replies, retweets et quoted
UTILISATION RESPONSABLE

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.

Questions fréquentes

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.

Références officielles

Source officielle de l'extracteur TwitterConfiguration officielle d'exempleOptions officielles
ÉTAPE SUIVANTE

Ressources associées