Windows executable
- Platform
- Windows
- File size
- 22.95 MiB
Choose Windows, macOS, Linux, or a Python-based installation and copy the matching commands. This page links to upstream sources and separates stable releases from development builds.
Choose your system. The download starts after a 15-second countdown.
How to Install gallery-dl on Windows, Mac & Linux. Choose your system. The download starts after a 15-second countdown. Check the filename and use the checksums published by the project when verifying a download.
Check the filename and use the checksums published by the project when verifying a download. Codeberg v1.32.8
Select a platform and method. The output includes installation, verification, and update commands from official upstream installation guidance.
The current PyPI release verified during this build is 1.32.8, published July 25, 2026. Always check the upstream release page before presenting a version as current.
If Python is already available, install the stable release with python -m pip install -U gallery-dl. On Windows, the upstream instructions recommend using py instead of python. If you do not want a Python installation, use the official standalone executable or a trusted package manager.
The best method is not simply the shortest command. Choose the package owner you already trust and understand. pip is cross-platform and usually receives stable gallery-dl releases promptly. Homebrew, Chocolatey, Scoop, Snap, MacPorts, and distribution packages integrate with their own update workflows but may publish on different schedules. The standalone executable bundles the runtime and is convenient on Windows systems without Python.
Avoid installing the same command through several managers. Multiple copies on PATH can make an update appear ineffective because the shell keeps launching a different executable. After installation, use the platform's command lookup and gallery-dl --version to confirm which copy is running.
| Method | Good fit | Update owner | Key trade-off |
|---|---|---|---|
| pip | Python users on any desktop OS | pip | Python and PATH must be configured |
| Standalone executable | Windows without Python | gallery-dl updater or replacement file | Runtime is bundled in a larger file |
| Homebrew | macOS and Homebrew Linux users | brew | Formula timing can differ from PyPI |
| Chocolatey / Scoop | Managed Windows tools | choco or scoop | Repository publication timing varies |
| Snap / distro package | Linux package management | snap or system manager | Stable repository may lag upstream |
Open a new terminal after installation so PATH changes are loaded. Run gallery-dl --version first. A version number confirms that the shell found an executable, but it does not prove it found the copy you intended. On Windows, use Get-Command in PowerShell or where in Command Prompt. On macOS and Linux, use command -v. Compare the path with the package manager or folder you selected.
Then run gallery-dl --help or gallery-dl --list-extractors. These are local checks and do not contact a target website. Only after they succeed should you test a public supported URL, preferably with --simulate. This sequence separates installation and PATH problems from extractor or authentication problems.
gallery-dl --versionGet-Command gallery-dlwhere gallery-dlcommand -v gallery-dlUse the same manager that installed gallery-dl. For pip, repeat the install command with -U. For Homebrew, Chocolatey, Scoop, or Snap, use that manager's upgrade command. The standalone executable supports gallery-dl -U in appropriate builds, while --update-check can report whether a newer version is available. If an update reports success but --version is unchanged, locate every executable on PATH and remove or deprioritize stale duplicates.
The stable PyPI version verified for this implementation is 1.32.8, published July 25, 2026. That fact will become stale, so the permanent advice is to verify PyPI or the upstream release page at the time of installation. Do not download a file from an unrelated mirror merely because it advertises a higher version.
Use PyPI, an upstream standalone release, or a recognized package repository when reliability matters. Stable builds are appropriate for most users and scheduled archive jobs.
A development build can contain a recent extractor fix before the next stable release, but it can also change behavior. Use it only for a documented reason and keep the exact source reference so you can reproduce or roll back the environment.
A not-recognized or command-not-found message means the shell did not locate the program; it is not a website support failure. Close and reopen the terminal, confirm the selected environment, and locate the installed file. Python user installations may place scripts in a user-level Scripts or bin directory that is not on PATH. You can also test through the interpreter with python -m gallery_dl where appropriate.
If several Python installations exist, run the pip command through the exact interpreter you plan to use. python -m pip and py -m pip are clearer than a bare pip command because they show which runtime owns the installation. Do not fix a PATH issue by copying executables into random system folders.
py -m pip install -U gallery-dl
py -m gallery_dl --versionpython -m pip install -U gallery-dl
python -m gallery_dl --versionUse the diagnostic wizard on the troubleshooting page and select “gallery-dl is not recognized” for an operating-system-specific sequence.
Install gallery-dl with one package owner and write down which owner you chose. After you install gallery-dl, open a new terminal, locate the resolved executable, and confirm its version. This short record prevents a later pip, Homebrew, Scoop, or standalone update from targeting a different copy.
Install gallery-dl again only when verification shows that the intended environment is missing or outdated. Do not stack package managers as a PATH workaround. A complete install gallery-dl check ends with --help, --list-extractors, and one public --simulate request; those tests separate installation success from website authentication or extractor behavior.
If Python is already configured, use python -m pip install -U gallery-dl. Windows users can use py -m pip. Without Python, use an upstream standalone executable or a package manager you already trust.
No. The standalone executable bundles a Python runtime and required packages. Follow the upstream Windows requirements and verify the file source before running it.
The scripts directory may not be on PATH, the terminal may need to be reopened, or pip may belong to a different Python installation. Locate the executable and test python -m gallery_dl.
Use the same manager that installed it: pip -U, brew upgrade, choco upgrade, scoop update, snap refresh, or the supported standalone updater. Verify the command path and version afterward.
Only when you need a documented fix that is not in the stable release. Development builds may change behavior, so stable releases are the better default.
Install gallery-dl from an upstream-linked release, PyPI, or a recognized package repository. Avoid unrelated mirrors and pages that imply official affiliation without evidence.