# gallery-dl.wiki Full Context > Complete English context for gallery-dl.wiki, an independent local-first gallery-dl command tool and documentation site. ## Site Background gallery-dl.wiki is an independent English-language tool site for people who use the open-source gallery-dl command-line program. Its purpose is to turn recurring setup and troubleshooting questions into focused, browser-based utilities and practical documentation. The site is not gallery-dl's official documentation, is not operated by its maintainer, and is not affiliated with any website that gallery-dl supports. The site does not run gallery-dl on a server and does not download or store media for visitors. Command, config, filter, search, install, cookie-selector, and diagnostic values are processed by JavaScript in the visitor's browser. A visitor reviews and copies the output, installs gallery-dl locally, and runs it on a device they control. The tools never need raw cookies, passwords, access tokens, or authorization headers. The site's safety model is based on authorized use. Users are told to access only content they have permission to view and copy, comply with copyright and platform terms, respect rate limits and account permissions, avoid bypassing access controls, and begin unfamiliar work with --simulate and a small range. Generated commands are drafts that must be checked for URLs, local paths, browser profiles, filters, archive files, storage requirements, and shell quoting. ## Content Category Details The [gallery-dl download homepage](https://gallery-dl.wiki/) links to the verified upstream Codeberg files for gallery-dl 1.32.15. Users choose the Windows executable or Linux binary, see a 15-second accessible countdown, and then receive the selected file from Codeberg. gallery-dl.wiki does not modify or repackage the release files. The [supported-sites checker](https://gallery-dl.wiki/supported-sites/) is intentionally curated toward mainstream, non-explicit discovery. It filters by site name, domain, capability, authentication type, and category. Entries explain typical URL capabilities rather than claiming that every page on a domain works. Authentication labels include no required auth listed, cookies, OAuth, and supported username/password flows. Support changes when sites change APIs, markup, login, or access policy, so the page links directly to upstream sources. The [installation selector](https://gallery-dl.wiki/install/) covers Windows, macOS, Linux, and general Python environments. It provides copyable installation, verification, and update sequences for appropriate methods such as pip, pipx, gallery-dl.exe, Homebrew, Chocolatey, Scoop, Snap, and MacPorts. Users are advised to update through the same channel that installed the command, avoid overlapping installations they cannot distinguish, and confirm the executable with gallery-dl --version. The release reference verified on October 8, 2026 is PyPI version 1.32.15, published October 3, 2026. The [gallery-dl update guide](https://gallery-dl.wiki/update/) focuses on the maintenance intent behind "how to update gallery-dl". It starts by recording the installed version and resolved executable, then maps pip, Homebrew, Chocolatey, Scoop, Snap, standalone, and gallery-dl self-update options to the correct owner. It explains why PATH duplicates make an update appear ineffective, uses --version, where/which, --config-status, and a small --config-ignore --simulate test for verification, and separates version, configuration, authentication, rate-limit, and site-policy failures. The guide's official release check on August 16, 2026 found gallery-dl 1.32.15, published August 1, 2026, from GitHub and Codeberg sources; readers should recheck upstream before relying on that version later. The [how-to-use guide](https://gallery-dl.wiki/how-to-use/) includes the verified download panel and explains a progressive workflow. The recommended order is to download the correct platform file, verify installation, simulate one canonical public URL, confirm extractor recognition, perform a small download, select an output root, add authorized local authentication if necessary, create a download archive for repeat jobs, inspect metadata with -K, and move stable options into a config after they work on the command line. The [gallery-dl GUI guide](https://gallery-dl.wiki/gui/) is an informational comparison of third-party graphical frontends, not an official gallery-dl product page. It explains that gallery-dl itself is a CLI, compares browser-based gdluxx, desktop-oriented Sora, and broader Windows or multi-downloader projects, and maps common workflows to the controls that deserve inspection. The guide emphasizes executable and version visibility, configuration export, queue state, local permissions, browser-cookie boundaries, and a reproducible --simulate handoff to the official CLI. Its three visual points are real README screenshots from gdluxx and Sora; they are labeled as third-party interface examples rather than official gallery-dl media. The [gallery-dl vs youtube-dl comparison](https://gallery-dl.wiki/gallery-dl-vs-youtube-dl/) is an informational comparison page, not a replacement downloader. It separates image-gallery and collection workflows from YouTube-first video workflows, compares URL support boundaries, output concerns, authentication caveats, and repeat-job patterns, then recommends a small --simulate test before scaling. Its three WebP visuals are labeled explanatory concepts rather than official product screenshots, and the page links to the official gallery-dl documentation, supported-sites reference, youtube-dl README, and PyPI release metadata. The [command reference](https://gallery-dl.wiki/commands/) provides a searchable library for basic downloads, simulation, destinations, browser cookies, archives, ranges, date windows, metadata, ZIP output, extractor information, metadata fields, config status, config isolation, extractor listing, and pip updates. It also includes the full builder for composing options. Examples use neutral URL and path placeholders and should be reviewed before execution. The [config generator](https://gallery-dl.wiki/config/) creates JSON under the extractor object. Visitors can set a base directory, filename format, archive path, browser-cookie selector, request delay, metadata output, or ZIP output. The resulting file is copied or downloaded locally. Guidance explains that configuration is JSON even when named gallery-dl.conf, that Windows backslashes must be escaped, that broad filename and filter defaults can fail when extractors expose different metadata, and that --config-status and --config-ignore are the fastest tools for proving configuration involvement. The [cookies helper](https://gallery-dl.wiki/cookies/) constructs --cookies-from-browser syntax from a browser, optional domain, optional profile, and target URL. It does not request cookie values. The guide recommends signing in through the site's normal browser flow, confirming content access in the exact profile, closing a browser when its cookie database is locked, running under the same operating-system user, and never publishing cookie files or authentication logs. A local cookies.txt file is described as a sensitive snapshot that may grant account access and can expire. The [troubleshooting wizard](https://gallery-dl.wiki/troubleshooting/) handles command-not-found, 403, 404, empty result, config, 429, and disk/interruption scenarios. Diagnostics separate installation, config, URL recognition, authentication, server response, and local output. The standard clean comparison is gallery-dl --config-ignore --simulate URL. A 401 typically indicates authentication; a 403 may reflect authentication, policy, rate limits, challenges, regional behavior, or extractor change; a 404 may reflect deletion, privacy, URL shape, or deliberately hidden availability. Users are told to stop repeated refused requests and redact secrets before seeking upstream support. The [gallery-dl Twitter / X guide](https://gallery-dl.wiki/twitter/) is a focused multilingual tutorial for individual status URLs and account media pages. It explains simulation, local browser-cookie authentication, limited first runs, stable download archives, output folders, metadata, extractor settings for replies, reposts, quoted posts and videos, rate-limit waiting, and clean configuration isolation. Three editorial diagrams illustrate the local workflow without pretending to be real X or gallery-dl screenshots. The [gallery-dl Instagram guide](https://gallery-dl.wiki/instagram/) is a focused multilingual tutorial for canonical Instagram post, profile, and media URLs. It explains simulation, local browser-cookie authentication, small first runs, stable download archives, configuration isolation, metadata checks, rate-limit and suspicious-activity troubleshooting, and responsible use. Its three WebP visuals are explanatory concepts rather than official Instagram or gallery-dl screenshots, and the page links to the official supported-sites list, Instagram extractor, configuration example, and PyPI release metadata. The [gallery-dl Reddit guide](https://gallery-dl.wiki/reddit/) is a focused multilingual tutorial for canonical Reddit post, subreddit, user, and account-linked URLs. It explains simulation, the boundary between public access and Reddit OAuth, small first runs, stable download archives, configuration isolation, metadata checks, 400/403/blocked troubleshooting, empty-result diagnosis, and responsible use. Its three WebP visuals are explanatory concepts rather than official Reddit or gallery-dl screenshots, and the page links to the official supported-sites list, configuration documentation, command options, and PyPI release metadata. The page's freshness check on August 10, 2026 verified gallery-dl 1.32.15 from official PyPI metadata and upstream Codeberg Windows and Linux release files. ### Key Technical Concepts gallery-dl's basic syntax is gallery-dl [OPTIONS] URLS. URLs and paths should normally be quoted because shell metacharacters and spaces can otherwise change interpretation. --destination sets a base output root; --directory sets an exact directory. --simulate extracts without downloading. -E exposes extractor information. -K lists metadata keywords that may be used by filename or filter expressions. A download archive stores successful extractor IDs and skips matching records in later runs. It provides repeat-job continuity but is not a backup of media. --range limits positional files, while --date-after and --date-before depend on date metadata supplied by an extractor. --filter evaluates a Python-style expression against extractor metadata and can silently exclude everything if the assumed field is missing. Every unfamiliar filter should be checked with -K and --simulate. Browser-cookie extraction reads a local browser profile. It should be used only with an account the user controls and content the account is authorized to view. OAuth is the documented authentication mechanism for some extractors. Authentication does not grant permission to republish content or bypass technical restrictions. ## User Value The site prioritizes official gallery-dl documentation, the official GitHub repository, official release pages, and PyPI for technical claims. Site-support descriptions are marked as curated or typical rather than exhaustive. Version-sensitive claims include a check date. Pages link to authoritative references and encourage users to consult their installed version's --help output because options and extractors can evolve. The site avoids explicit-platform targeting in its discovery directory and focuses on broad utility queries such as installation, commands, configuration, cookies, supported sites, usage, update, and troubleshooting. It does not present itself as an official product and does not promise access to private or restricted material. ### Privacy, Legal, and Contact The [About page](https://gallery-dl.wiki/about/) explains scope, independence, sourcing, safety principles, and corrections. The [Privacy Policy](https://gallery-dl.wiki/privacy-policy/) explains that tool inputs remain in-browser, while normal hosting logs, Microsoft Clarity analytics, Google advertising technologies, cookies, web beacons, IP addresses, identifiers, support email, retention, international processing, and rights may apply. It links prominently to Google's partner-sites explanation. The [Terms of Service](https://gallery-dl.wiki/terms-of-service/) limits use to lawful, authorized activity and explains responsibility for local execution, intellectual property, third parties, disclaimers, and liability. Factual corrections, privacy requests, accessibility issues, and broken links may be reported to support@gallery-dl.wiki. Reports should identify the affected public page and authoritative source without attaching raw cookies, tokens, private URLs, passwords, or identifying logs. ## Latest Update Content - 2026-08-01: Multilingual gallery-dl vs youtube-dl comparison guide added with localized metadata, URL/media decision table, small test commands, FAQ, official references, and three compressed explanatory WebP assets. - 2026-07-30: Multilingual gallery-dl Twitter / X guide added with localized metadata, commands, FAQ, hreflang, sitemap entries, real upstream references, and three compressed explanatory WebP assets. - 2026-08-06: Multilingual gallery-dl Instagram guide added with localized metadata, canonical URL tests, cookies, archives, FAQ, hreflang, sitemap entries, official references, and three compressed explanatory WebP assets. - 2026-08-10: Multilingual gallery-dl Reddit guide added with localized metadata, canonical URL tests, OAuth boundaries, archives, FAQ, hreflang, sitemap entries, official references, and three compressed explanatory WebP assets. - 2026-08-16: Multilingual gallery-dl update guide added with localized metadata, channel-specific commands, PATH/version verification, official release checks, FAQ, sitemap entries, and three compressed explanatory WebP assets. - 2026-08-22: Multilingual gallery-dl GUI comparison guide added with localized metadata, third-party frontend criteria, real gdluxx and Sora README screenshots, CLI handoff checks, FAQ, hreflang, and sitemap entries. - 2026-07-27: English homepage and seven functional core pages completed for gallery-dl.wiki. - 2026-07-27: Domain, navigation, canonical URLs, sitemap, robots directives, structured data, legal disclosures, and LLM discovery files aligned to gallery-dl.wiki. - 2026-08-01: PyPI release reference verified as gallery-dl 1.32.15, published August 1, 2026; future readers should recheck upstream for the current release. ## gallery-dl Pixiv Guide https://gallery-dl.wiki/pixiv/ A practical guide to Pixiv artwork, profile, ranking, search, series, and Sketch URL tests, local browser cookies, simulation, ranges, download archives, configuration, and error diagnosis. The page records gallery-dl 1.32.15 as checked on 2026-10-08 and directs readers to official upstream references for version-sensitive behavior.