agent safety

Agent safety answer

gallery-dl downloads media and may use cookies or credentials for private sources.

Credential access

Reads cookies, config files, netrc credentials, and output paths.

Remote mutation

Primarily downloads, but can access authenticated services.

Publish/artifact risk

Can create local archives of private or copyrighted media.

Recommended control

Gate cookie reads, authenticated downloads, and broad output paths.

Agent-use guidance

Allow public metadata checks; require approval for private downloads and credential use.

install

Additional install commands

macOS

Homebrewverified · 100%

brew install gallery-dl

local Homebrew formula metadata

MacPortsverified · 94%

sudo port install gallery-dl

MacPorts ports tree · net/gallery-dl/Portfile · source: api.github.com

Linux

Alpine Linux apkverified · 92%

sudo apk add gallery-dl

Alpine Linux edge package indexes · gallery-dl · source: dl-cdn.alpinelinux.org

Debian aptverified · 92%

sudo apt install gallery-dl

Debian stable package indexes · gallery-dl · source: deb.debian.org

Nixverified · 92%

nix profile install nixpkgs#gallery-dl

nixpkgs package indexes · pkgs/by-name/ga/gallery-dl/package.nix · source: api.github.com

Windows

Chocolateyverified · 92%

choco install gallery-dl

Chocolatey community package catalog · gallery-dl · source: community.chocolatey.org

Scoopverified · 92%

scoop install main/gallery-dl

Scoop official bucket manifest trees · bucket/gallery-dl.json · source: api.github.com

Windows Package Managerverified · 92%

winget install --id mikf.gallery-dl -e

Windows Package Manager source index · mikf.gallery-dl · source: cdn.winget.microsoft.com

overview

Package summary

Command-line downloader for image-hosting site galleries and collections

Project links

Commands and aliases

gallery-dl

history

Project history and usage

gallery-dl is a cross-platform command-line program for downloading image galleries and collections from many image-hosting and social sites. It is often treated as the image-gallery counterpart to video downloaders such as youtube-dl and yt-dlp.

Project history

The GitHub repository was created in October 2014 and long served as the project's primary development home. The current README states that active development has moved to Codeberg, and the Codeberg repository metadata records a March 2026 creation date.

Upstream documents GPL-2.0 licensing, Python 3.8+ support, a large extractor/configuration surface, and frequent release artifacts. GitHub release metadata shows versioned releases continuing into 2026.

Adoption history

gallery-dl has unusually broad package-manager adoption for a niche downloader. Upstream documents PyPI, standalone Windows/Linux executables, Snap, Chocolatey, Scoop, Homebrew, MacPorts, Docker, Nix, and Home Manager installation paths, while the supplied package facts also list apk, Debian, Ubuntu, winget, and other package-manager names.

The migration to Codeberg is significant for packagers because repository URLs, release tarballs, and development snapshots shifted away from GitHub while documentation and historical references still point to GitHub-hosted material.

How it is used

Users run gallery-dl with one or more URLs and command-line options. It can also be configured through JSON-style configuration files, with optional YAML/TOML support, site-specific extractor settings, output formatting, cookies, credentials, API keys, and cache handling.

The README documents optional integrations with yt-dlp or youtube-dl for HLS/DASH video downloads, FFmpeg and mkvmerge for Pixiv Ugoira handling, and other optional dependencies for proxies, compression, keyrings, PostgreSQL archives, trust stores, and templates.

Why package nerds care

gallery-dl is package-nerd significant because it is a constantly changing web-scraper/downloader packaged across many ecosystems. Maintainers have to track fast upstream releases, optional dependency behavior, changing site extractors, default config locations, credential storage in config files, and the GitHub-to-Codeberg source migration.

Timeline

2014: GitHub repository created.
2020s: Upstream README documents installation through PyPI, standalone binaries, Snap, Chocolatey, Scoop, Homebrew, MacPorts, Docker, Nix, and Home Manager.
2026: Codeberg repository created and README states active development moved there.
2026: GitHub release metadata lists v1.32.5 published on June 30.

Related projects

yt-dlp and youtube-dl are optional integrations for HLS/DASH video downloads.
FFmpeg and mkvmerge are optional helpers for Pixiv Ugoira conversion and timing.
The project now spans Codeberg for active source development, GitHub for historical repository/docs references, and gdl-org.github.io for generated documentation.

Sources

security posture

No protected-tool coverage found yet

No matching local secret-handling manifest was found for gallery-dl. Nucleus package metadata is still published here so future coverage has a stable package URL.

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 6 platform targets.
Installs with 5 runtime dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix: /etc/gallery-dl.conf${XDG_CONFIG_HOME}/gallery-dl/config.json${HOME}/.config/gallery-dl/config.json${HOME}/.gallery-dl.conf

Credential files

Credential-bearing paths to review before unattended agent runs.

Unix: /etc/gallery-dl.conf${XDG_CONFIG_HOME}/gallery-dl/config.json${HOME}/.config/gallery-dl/config.json${HOME}/.gallery-dl.conf

executables

Installed executables

Command	Kind	Exposure	Note
`gallery-dl`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08

manager version1.32.5

manager updated2026-07-01

local dataok

upstreamnot checked

latest detectednot detected

https://github.com/mikf/gallery-dl

infoNo cached GitHub release or tag data was available.https://github.com/mikf/gallery-dlnone confidence

install metadata

Package metadata

Package key	brew:gallery-dl
Version	1.32.5
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/gallery-dl
Homepage	https://github.com/mikf/gallery-dl
Repository	https://github.com/mikf/gallery-dl
Upstream docs	https://gdl-org.github.io/docs
License	GPL-2.0-only
Source archive	https://files.pythonhosted.org/packages/b5/d3/1183e8994b48af8850c7eadc3881490d8671a7fb7d044bb839f9b6d028d7/gallery_dl-1.32.5.tar.gz
Last updated	2026-07-01T09:53:56Z
Pulse	updated
Dependencies	certifi, cryptography, libyaml, python@3.14, yt-dlp
Bottle	available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	not defined
Service	none declared

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	gallery-dl
Version Scheme	0
Revision	0
Head Version	HEAD
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	head stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Debian apt95%

gallery-dl 1.29.7-1

command-line program to download image galleries

https://github.com/mikf/gallery-dl

sudo apt install gallery-dl

Section: web
Architecture: all
2 dependencies
4 optional deps
normalized package name match
Matched by: Gallery Dl

Debian stable package indexes · deb.debian.org · Debian stable package indexes: gallery-dl from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

Nix95%

gallery-dl

nix profile install nixpkgs#gallery-dl

normalized package name match
Matched by: Gallery Dl

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/ga/gallery-dl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

Ubuntu apt95%

gallery-dl 1.26.9-1

command-line program to download image galleries

https://github.com/mikf/gallery-dl

sudo apt install gallery-dl

Section: universe/web
Architecture: all
2 dependencies
4 optional deps
normalized package name match
Matched by: Gallery Dl

Ubuntu 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: gallery-dl from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz

apk95%

gallery-dl 1.32.2-r0

CLI tool to download image galleries

https://codeberg.org/mikf/gallery-dl

sudo apk add gallery-dl

License: GPL-2.0-or-later
Architecture: x86_64
Source Package: gallery-dl
1 dependencies
1 provides
normalized package name match
Matched by: Gallery Dl

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: gallery-dl from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

apk95%

gallery-dl-bash-completion 1.32.2-r0

Bash completions for gallery-dl

https://codeberg.org/mikf/gallery-dl

sudo apk add gallery-dl-bash-completion

License: GPL-2.0-or-later
Architecture: x86_64
Source Package: gallery-dl
normalized package name match
Matched by: Gallery Dl

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: gallery-dl-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

apk95%

gallery-dl-doc 1.32.2-r0

CLI tool to download image galleries (documentation)

https://codeberg.org/mikf/gallery-dl

sudo apk add gallery-dl-doc

License: GPL-2.0-or-later
Architecture: x86_64
Source Package: gallery-dl
normalized package name match
Matched by: Gallery Dl

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: gallery-dl-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

apk95%

gallery-dl-fish-completion 1.32.2-r0

Fish completions for gallery-dl

https://codeberg.org/mikf/gallery-dl

sudo apk add gallery-dl-fish-completion

License: GPL-2.0-or-later
Architecture: x86_64
Source Package: gallery-dl
normalized package name match
Matched by: Gallery Dl

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: gallery-dl-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

apk95%

gallery-dl-pyc 1.32.2-r0

Precompiled Python bytecode for gallery-dl

https://codeberg.org/mikf/gallery-dl

sudo apk add gallery-dl-pyc

License: GPL-2.0-or-later
Architecture: x86_64
Source Package: gallery-dl
1 dependencies
normalized package name match
Matched by: Gallery Dl

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: gallery-dl-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

apk95%

gallery-dl-zsh-completion 1.32.2-r0

Zsh completions for gallery-dl

https://codeberg.org/mikf/gallery-dl

sudo apk add gallery-dl-zsh-completion

License: GPL-2.0-or-later
Architecture: x86_64
Source Package: gallery-dl
normalized package name match
Matched by: Gallery Dl

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: gallery-dl-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

MacPorts95%

gallery-dl

sudo port install gallery-dl

normalized package name match
Matched by: Gallery Dl

MacPorts ports tree · api.github.com · MacPorts ports tree: net/gallery-dl/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

Chocolatey95%

gallery-dl

choco install gallery-dl

normalized package name match
Matched by: Gallery Dl

Chocolatey community package catalog · community.chocolatey.org · Chocolatey community package catalog: gallery-dl from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','flow-launcher'

Scoop95%

main/gallery-dl

scoop install main/gallery-dl

normalized package name match
Matched by: Gallery Dl

Scoop official bucket manifest trees · api.github.com · Scoop official bucket manifest trees: bucket/gallery-dl.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

winget95%

mikf.gallery-dl

winget install --id mikf.gallery-dl -e

normalized package name match
Matched by: Gallery Dl

Windows Package Manager source index · cdn.winget.microsoft.com · Windows Package Manager source index: mikf.gallery-dl from https://cdn.winget.microsoft.com/cache/source.msix

winget95%

mikf.gallery-dl.Nightly

winget install --id mikf.gallery-dl.Nightly -e

normalized package name match
Matched by: Gallery Dl

Windows Package Manager source index · cdn.winget.microsoft.com · Windows Package Manager source index: mikf.gallery-dl.Nightly from https://cdn.winget.microsoft.com/cache/source.msix

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/gallery-dl.yml

Used sources

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated agent safety answer
curated configuration and credential file locations
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment

Install gallery-dl with Homebrew, apk, chocolatey, apt, MacPorts, Nix, scoop, winget

Agent safety answer

Credential access

Remote mutation

Publish/artifact risk

Recommended control

Agent-use guidance

Additional install commands

macOS

Linux

Windows

Package summary

Project links

Commands and aliases

Project history and usage

Project history

Adoption history

How it is used

Why package nerds care

Timeline

Related projects

Sources

No protected-tool coverage found yet

Install behavior

Recommended review

Configuration and credential file locations

Configuration files

Credential files

Installed executables

Version and freshness

Package metadata

Source database details

Other package-manager records

Internal package links

Topical hubs

Related tools

Same workflow

Agent security guides

Generated from repository data

Combined YAML source

Used sources