OFFICIAL INSTALL PATHS

How to Install gallery-dl

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.

pip and package managersStandalone executableVerification and updates
OFFICIAL DOWNLOAD

How to Install gallery-dl on Windows, Mac & Linux

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.

Version1.32.8
ReleasedJuly 25, 2026
SourceOfficial Codeberg release
LicenseGPL-2.0
Choose a download to start the countdown.

Check the filename and use the checksums published by the project when verifying a download. Codeberg v1.32.8

INSTALL SELECTOR

Install gallery-dl with the right command

Select a platform and method. The output includes installation, verification, and update commands from official upstream installation guidance.

Install and verify

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.

Recommended default

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.

PICK ONE OWNER

Choose an installation method you can update

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.

MethodGood fitUpdate ownerKey trade-off
pipPython users on any desktop OSpipPython and PATH must be configured
Standalone executableWindows without Pythongallery-dl updater or replacement fileRuntime is bundled in a larger file
HomebrewmacOS and Homebrew Linux usersbrewFormula timing can differ from PyPI
Chocolatey / ScoopManaged Windows toolschoco or scoopRepository publication timing varies
Snap / distro packageLinux package managementsnap or system managerStable repository may lag upstream
VERIFY BEFORE USE

Confirm that gallery-dl is installed correctly

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.

Version check
gallery-dl --version
PowerShell command location
Get-Command gallery-dl
Command Prompt command location
where gallery-dl
macOS or Linux command location
command -v gallery-dl
STAY CURRENT

How to update gallery-dl without updating the wrong copy

Use 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.

Stable release

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.

  • Prefer an upstream-linked source.
  • Record the install method.
  • Verify version and command path.
  • Test a public URL with --simulate.

Development build

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.

  • Do not label a development build as stable.
  • Keep a working stable command available.
  • Re-test configuration and archive behavior.
  • Avoid unofficial executable mirrors.
PATH RECOVERY

Fix gallery-dl is not recognized

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.

Windows Python launcher
py -m pip install -U gallery-dl
py -m gallery_dl --version
Python module form
python -m pip install -U gallery-dl
python -m gallery_dl --version
Still blocked?

Use the diagnostic wizard on the troubleshooting page and select “gallery-dl is not recognized” for an operating-system-specific sequence.

FINISH THE INSTALL

Install gallery-dl with one package owner

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.

Authoritative references

gallery-dl on PyPIUpstream gallery-dl repository
NEXT STEP

Related gallery-dl resources

FAQ

gallery-dl installation FAQ

What is the easiest way to install gallery-dl?

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.

Do I need Python for gallery-dl.exe?

No. The standalone executable bundles a Python runtime and required packages. Follow the upstream Windows requirements and verify the file source before running it.

Why is gallery-dl not recognized after pip install?

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.

How do I update 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.

Is a nightly or development build better?

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.

Where should I download and install gallery-dl?

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.