This gallery-dl Reddit guide explains how to choose a canonical URL, simulate extraction, separate public access from OAuth, limit the first batch, prevent duplicates, and diagnose 400, 403, blocked, and empty-result failures.
Yes, gallery-dl has a Reddit extractor, but the exact URL type and account permissions determine what works. Start with one canonical public URL and --simulate. For saved, private, or account-linked areas, configure the OAuth fields described in the official documentation instead of trying repeated anonymous requests.
A gallery-dl Reddit job should begin with the smallest URL that represents your goal: a public post, a subreddit listing, a user page, or another URL type listed by the installed extractor. Copy the canonical URL from the normal browser address bar, remove tracking parameters when practical, and quote the URL in your shell. A shortened share link or a redirected mobile URL can make a support problem look like a command problem.
Simulation is the cleanest first check because it can identify the extractor and show what would be selected without writing media. It also separates installation, URL recognition, access, configuration, and destination decisions. Use a public URL you are authorized to view, then inspect the result before adding filters, archives, or a large range.
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 and POST_ID are examples, not ready-to-run values. Use a real URL and content you are authorized to access, and keep --simulate until the selected scope makes sense.
The upstream supported-sites reference lists Reddit as an extractor, but a listed domain is not a promise that every page, search, account state, or region will behave identically. Public post and subreddit URLs are useful starting points. Saved items, personalized feeds, private communities, and other account-linked surfaces can require a valid OAuth setup and may expose a different set of metadata or access rules.
Treat support as a match between URL type, installed release, account access, and extractor capability. If a recognized Reddit domain produces an unsupported URL message, compare the exact path with the upstream support row before changing filenames or output options. A successful public test also does not grant permission to republish the content.
Use one public post or a small subreddit view for the clearest baseline. Confirm the URL, selected media, filename, and destination before testing a broad feed.
Account-linked areas can need OAuth and may be limited by the account's own permissions. Do not infer private or saved-content support from an anonymous public post.
A Reddit page can contain images, galleries, video links, text, previews, and deleted or inaccessible items. Decide which output you need and inspect the simulated selection before scaling up.
| Goal | First check | Why it matters |
|---|---|---|
| One public post | --simulate URL | Separates URL recognition from download writes |
| A subreddit feed | --simulate --range 1-10 URL | Keeps the first result small and reviewable |
| Saved or account content | Official OAuth configuration | Uses the account access you control |
| Filename or filters | -K URL | Shows metadata before expressions are written |
Anonymous access is not a reliable substitute for account-linked Reddit content. When the extractor requires OAuth, create or use the application credentials described by the official gallery-dl configuration documentation, keep the client secret private, and provide a clear user-agent. The goal is to let your local installation request content through an account and application you control, not to bypass a restriction.
Keep authentication separate from the public first test. First prove that the installed version recognizes a public URL. Then add the smallest OAuth configuration, test the exact account-linked URL with --simulate, and only afterward add a range or archive. If OAuth fails, check the client ID, client secret, user-agent, account permission, and current upstream notes one at a time.
{
"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/"Client secrets, tokens, account identifiers, browser data, and unredacted logs can grant access. Use placeholders in examples and keep real credentials on the device that runs gallery-dl.
After a simulation succeeds, choose a predictable destination and make the first real run intentionally small. A range gives you a chance to inspect filenames, image quality, video handling, missing posts, and storage behavior before a feed becomes a large job. Use one stable archive for repeat work; an archive records successful extractor IDs and is not a backup of the files themselves.
Move options into a config only after the command-line version works. Use -K to inspect metadata before writing filename or filter expressions, and keep destination paths, archive files, and account-specific values out of public support snippets. If a repeat job changes behavior after an update, compare the installed version and a clean simulation before rebuilding the whole configuration.
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/"| Goal | Option | Why it matters |
|---|---|---|
| Test without files | --simulate | Checks extractor, access, and selection first |
| Limit the first batch | --range 1-10 | Makes output and storage easy to review |
| Prevent repeat duplicates | --download-archive FILE | Keeps successful IDs across runs |
| Set a base folder | --destination DIR | Separates the job from unrelated downloads |
| Inspect available fields | -K URL | Prevents guessed filters from excluding everything |
Do not treat every Reddit failure as a missing flag. A 400 can come from an invalid or changed URL, incomplete OAuth data, or a request the extractor no longer builds. A 403 or blocked response can reflect account access, rate limits, platform policy, or an extractor change. Stop repeated retries, confirm the URL in a normal browser, run a clean simulation, and check the installed version before changing several options together.
An empty result can also be caused by a restrictive filter, an archive that already contains the matching IDs, deleted content, or a URL type that selects no accessible media. Compare the same URL with --config-ignore, then add OAuth, range, archive, destination, and filters one at a time. This creates evidence for the failing layer instead of turning a transient response into a large retry loop.
| Symptom | First check | Safe next step |
|---|---|---|
| 400 Bad Request | Canonical URL, OAuth fields, and version | Run a clean simulation and review official notes |
| 403 or blocked | Normal browser access and rate-limit state | Stop retries; wait or reduce scope |
| No extractor found | Supported-sites row and exact URL path | Try a canonical public URL and update through the same channel |
| No files selected | --config-ignore with no filter | Check URL type, access, metadata, and range |
| Everything is skipped | Archive path and contents | Use a separate diagnostic archive only when needed |
| OAuth error | Client ID, secret, user-agent, and account access | Change one credential/config field at a time |
gallery-dl is a local downloader, not a permission system. Download and reuse only content you are authorized to access and use. Respect Reddit rules, community expectations, privacy, copyright, account permissions, and rate limits. A technically reachable URL is not automatically a license to republish its content, and OAuth does not expand the permissions of your account.
For this page's freshness check on August 10, 2026, the site verified gallery-dl 1.32.9 from official PyPI metadata and checked the upstream Codeberg Windows and Linux release files. Version-sensitive extractor behavior can change, so run gallery-dl --version and recheck the official support and configuration documentation whenever a previously working Reddit command changes.
The current upstream supported-sites reference lists Reddit as an extractor. Your installed version, exact URL type, account access, region, and current platform behavior still determine the result, so simulate the exact URL first.
Start with a quoted canonical public Reddit post or subreddit URL and run gallery-dl --config-ignore --simulate URL. If the selection is correct, add a small range, a local destination, and a stable download archive before expanding the job.
Public URL tests may work without account credentials, but saved, private, or account-linked areas can require OAuth. Use the official configuration fields, keep client secrets private, and test the exact URL with --simulate.
Check the canonical URL, installed version, OAuth fields, and user-agent. Compare the command with --config-ignore --simulate, stop repeated retries, and consult the current upstream configuration or issue guidance before changing filters or output settings.
A 403 can reflect account permissions, rate limits, platform policy, regional behavior, or an extractor change. Confirm normal browser access, reduce scope, wait, and avoid parallel retry loops or attempts to bypass access controls.
Check the URL type, extractor recognition, account access, filters, range, deleted content, and archive. Run the same URL with --config-ignore and no filter, then add one setting back at a time.
Use --download-archive with one stable local archive path. gallery-dl records successful extractor identifiers and skips matching items on later runs; the archive is not a backup of the downloaded media.
The version verified for this page on August 10, 2026 is gallery-dl 1.32.9 from official PyPI metadata and upstream release files. Recheck gallery-dl --version and the official release before relying on version-sensitive behavior.