Ce guide gallery-dl pour Reddit explique comment choisir une URL canonique, simuler l'extraction, distinguer l'accès public d'OAuth, limiter le premier lot, éviter les doublons et diagnostiquer les erreurs 400, 403, les blocages et les résultats vides.
Oui, gallery-dl possède un extracteur Reddit, mais le type exact d'URL et les droits du compte déterminent le résultat. Commencez par une URL publique canonique et --simulate. Pour les éléments enregistrés, privés ou liés à un compte, configurez les champs OAuth de la documentation officielle au lieu de répéter des requêtes anonymes.
Choisissez l'URL la plus petite qui représente votre objectif : une publication publique, un subreddit, une page utilisateur ou un autre type reconnu par l'extracteur installé. Copiez l'URL canonique depuis le navigateur, retirez les paramètres de suivi si possible et mettez l'URL entre guillemets.
--simulate vérifie l'extracteur et la sélection sans écrire de média. Il aide à séparer l'installation, la reconnaissance de l'URL, l'accès, la configuration et le dossier de destination avant d'ajouter une plage, un filtre ou une archive.
gallery-dl --config-ignore --simulate "https://www.reddit.com/r/SUBREDDIT/"gallery-dl --simulate "https://www.reddit.com/comments/POST_ID/"gallery-dl -E "https://www.reddit.com/r/SUBREDDIT/"gallery-dl -K "https://www.reddit.com/comments/POST_ID/"SUBREDDIT et POST_ID sont des exemples. Utilisez une URL réelle que vous êtes autorisé à consulter et conservez --simulate jusqu'à ce que la sélection soit correcte.
La liste officielle des sites pris en charge présente Reddit comme un extracteur. Cela ne garantit pas que chaque page, recherche, état de compte ou région réagira de la même manière. Les publications publiques et les subreddits sont de bons points de départ ; les éléments enregistrés, fils personnalisés et communautés privées peuvent nécessiter OAuth.
Évaluez la prise en charge en combinant le type d'URL, la version installée, les droits du compte et les capacités de l'extracteur. Une réussite sur une publication publique n'accorde pas le droit de republier son contenu.
Utilisez une seule publication ou une petite vue de subreddit pour vérifier l'URL, les médias, les noms de fichiers et la destination avant d'élargir le flux.
Les zones liées au compte peuvent exiger OAuth et restent limitées par les droits de ce compte. Ne déduisez pas la prise en charge du contenu privé d'un test public anonyme.
Une page Reddit peut mélanger images, galeries, vidéos, texte, aperçus et éléments supprimés. Vérifiez la sélection simulée avant de lancer un travail plus large.
| Objectif | Premier contrôle | Pourquoi |
|---|---|---|
| Une publication publique | --simulate URL | Sépare la reconnaissance de l'URL de l'écriture |
| Flux d'un subreddit | --simulate --range 1-10 URL | Garde le premier résultat vérifiable |
| Contenu de compte | Configuration OAuth officielle | Utilise les droits que vous contrôlez |
| Noms ou filtres | -K URL | Montre les champs avant d'écrire une expression |
L'accès anonyme ne remplace pas l'accès à un contenu Reddit lié à un compte. Lorsque l'extracteur demande OAuth, utilisez les identifiants d'application décrits dans la documentation officielle de configuration, gardez le secret client confidentiel et définissez un user-agent clair. Cette configuration utilise un compte et une application que vous contrôlez ; elle ne contourne pas une restriction.
Séparez le premier test public de l'authentification. Vérifiez d'abord l'URL publique, ajoutez ensuite la configuration OAuth minimale, puis testez l'URL du compte avec --simulate. En cas d'échec, contrôlez l'ID client, le secret, le user-agent et les droits un par un.
{
"extractor": {
"reddit": {
"client-id": "YOUR_CLIENT_ID",
"client-secret": "YOUR_CLIENT_SECRET",
"user-agent": "gallery-dl/1.32.9 by YOUR_USERNAME"
}
}
}gallery-dl --simulate "https://www.reddit.com/user/USERNAME/saved/"gallery-dl --config-ignore --simulate "https://www.reddit.com/r/SUBREDDIT/"Secrets clients, tokens, identifiants de compte, données de navigateur et journaux non masqués peuvent donner accès à un compte. Utilisez des espaces réservés dans les exemples et gardez les valeurs réelles sur l'appareil qui exécute gallery-dl.
Après une simulation réussie, choisissez une destination prévisible et lancez volontairement un premier lot réduit. Une plage permet de vérifier les noms, la qualité, les vidéos, les publications manquantes et le stockage. Pour les tâches répétées, utilisez une archive stable : elle conserve les identifiants extraits avec succès, mais ne remplace pas une sauvegarde.
Ne déplacez les options dans une configuration qu'après avoir validé la commande. Utilisez -K avant de rédiger un nom ou un filtre et gardez les chemins, archives et valeurs liées au compte hors des extraits publics.
gallery-dl --range "1-10" --download-archive "reddit.sqlite3" "https://www.reddit.com/r/SUBREDDIT/"gallery-dl --destination "D:/Media/Reddit" --download-archive "reddit.sqlite3" "https://www.reddit.com/r/SUBREDDIT/"gallery-dl --write-metadata --download-archive "reddit.sqlite3" "https://www.reddit.com/r/SUBREDDIT/"| Objectif | Option | Pourquoi |
|---|---|---|
| Tester sans fichiers | --simulate | Vérifie d'abord l'extracteur et la sélection |
| Limiter le premier lot | --range 1-10 | Rend le résultat facile à examiner |
| Éviter les doublons | --download-archive FILE | Conserve les identifiants réussis |
| Définir un dossier | --destination DIR | Sépare ce travail des autres téléchargements |
| Inspecter les champs | -K URL | Évite qu'un filtre supposé exclue tout |
Ne considérez pas chaque erreur Reddit comme une option manquante. Une erreur 400 peut venir d'une URL changée, d'un OAuth incomplet ou d'une requête que l'extracteur ne construit plus. Un 403 ou un blocage peut refléter les droits, une limite de débit, une règle de plateforme, la région ou une modification de l'extracteur. Arrêtez les tentatives répétées, vérifiez l'URL dans un navigateur et relancez une simulation propre.
Un résultat vide peut aussi être causé par un filtre trop strict, une archive contenant déjà les identifiants, du contenu supprimé ou un type d'URL sans média accessible. Comparez avec --config-ignore et sans filtre, puis réintroduisez OAuth, plage, archive, destination et filtre un par un.
| Symptôme | Premier contrôle | Étape prudente |
|---|---|---|
| 400 Bad Request | URL canonique, OAuth, version | Simulation propre et documentation officielle |
| 403 ou blocage | Accès navigateur et état de limitation | Arrêter, attendre ou réduire la portée |
| Aucun extracteur | Ligne supported-sites et chemin exact | Tester une URL publique canonique |
| Aucun fichier sélectionné | --config-ignore sans filtre | Vérifier URL, accès, métadonnées et plage |
| Tout est ignoré | Chemin et contenu de l'archive | Utiliser une archive de diagnostic séparée si nécessaire |
| Erreur OAuth | ID, secret, user-agent et droits | Modifier un seul champ à la fois |
gallery-dl est un téléchargeur local, pas un système de permission. Enregistrez et utilisez uniquement les contenus auxquels vous avez droit. Respectez les règles de Reddit, la vie privée, le droit d'auteur, les droits du compte et les limites de débit. OAuth n'élargit pas les permissions de votre compte.
Pour la vérification de fraîcheur du 10 août 2026, cette page a contrôlé gallery-dl 1.32.9 dans les métadonnées officielles PyPI et les fichiers Windows et Linux de la release Codeberg. Exécutez gallery-dl --version et consultez les documents officiels si le comportement change.
La liste officielle des sites pris en charge présente Reddit comme un extracteur. La version installée, le type d'URL, les droits du compte, la région et l'état actuel de la plateforme déterminent le résultat : simulez donc l'URL exacte.
Commencez par une URL publique canonique entre guillemets et lancez gallery-dl --config-ignore --simulate URL. Si la sélection est correcte, ajoutez une petite plage, une destination locale et une archive stable.
Les tests publics peuvent fonctionner sans identifiants, mais les zones enregistrées, privées ou liées au compte peuvent exiger OAuth. Utilisez les champs officiels et testez l'URL exacte avec --simulate.
Vérifiez l'URL canonique, la version, les champs OAuth et le user-agent. Comparez avec --config-ignore --simulate, arrêtez les répétitions et consultez la configuration officielle.
Les droits, limites de débit, règles de plateforme, comportement régional ou changement d'extracteur peuvent en être la cause. Vérifiez l'accès normal, réduisez la portée, attendez et n'essayez pas de contourner la restriction.
Vérifiez le type d'URL, l'extracteur, les droits, les filtres, la plage, le contenu supprimé et l'archive. Comparez sans configuration et sans filtre, puis réactivez les réglages un par un.
Utilisez --download-archive avec un chemin local stable. gallery-dl enregistre les identifiants extraits avec succès et ignore les correspondances lors des exécutions suivantes ; l'archive n'est pas une sauvegarde des médias.
La version vérifiée le 10 août 2026 est gallery-dl 1.32.9 selon les métadonnées PyPI et les fichiers upstream. Vérifiez gallery-dl --version et la release officielle avant de dépendre d'un comportement sensible à la version.