Credential access
Reads cookies, config files, netrc credentials, and output paths.
brew / rank 863
Install gallery-dl with Homebrew
Command-line downloader for image-hosting site galleries and collections. Version 1.32.8 via Homebrew; verified 2026-07-26.
agent safety
Agent safety answer
gallery-dl downloads media and may use cookies or credentials for private sources.
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-dlprovider-native install command
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
- https://api.github.com/repos/mikf/gallery-dl
- https://api.github.com/repos/mikf/gallery-dl/releases?per_page=5
- https://codeberg.org/api/v1/repos/mikf/gallery-dl
- https://codeberg.org/mikf/gallery-dl
- https://github.com/mikf/gallery-dl
- https://raw.githubusercontent.com/mikf/gallery-dl/master/README.rst
- https://raw.githubusercontent.com/mikf/gallery-dl/master/docs/configuration.rst
- https://raw.githubusercontent.com/mikf/gallery-dl/master/docs/options.md
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 bottle metadata was recorded.
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 | executable | indexed executable | Discovered from the local executable index. |
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-08-03
manager version1.32.8
manager updated2026-07-26
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:gallery-dl |
|---|---|
| Version | 1.32.8 |
| Package manager | Homebrew |
| Homepage | https://codeberg.org/mikf/gallery-dl |
| Last updated | 2026-07-26T09:23:39Z |
| Pulse | updated |
| Bottle | not recorded |
| Service | none declared |
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.
Used sources
- Geiger risk classifier
- Nucleus package database
- curated agent safety answer
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation