gallery-dl
gallery-dl — утилита командной строки для скачивания изображений и коллекций медиа из галерей, имиджбордов, социальных сетей и хостингов. Написана на Python (лицензия GPL-2.0), активно развивается, для каждого сайта есть отдельный экстрактор, который сохраняет и метаданные.
Основной репозиторий: codeberg.org/mikf/gallery-dl. В 2026 году разработка переехала с GitHub на Codeberg; репозиторий github.com/mikf/gallery-dl пока обновляется как зеркало.
Когда использовать
✅ Подходит, если нужно:
- массово скачать изображения из Instagram, Twitter/X, Pixiv, DeviantArt, Tumblr, Reddit, VK, Danbooru и других сайтов;
- сохранить метаданные (теги, описание, автор, дата) рядом с файлами в JSON;
- иметь гибкую фильтрацию (по расширению, размеру файла, дате поста, тегам);
- вести инкрементальный архив с
--download-archive(база SQLite).
❌ Не лучший выбор, е сли:
- цель — видео, а не изображения — yt-dlp;
- нужна визуальная дедупликация (по перцептивным хешам) — посмотрите Hydrus Network или собственный пайплайн;
- нужно сохранить страницу целиком с интерфейсом — SingleFile или Browsertrix Crawler;
- платформа не поддерживается — проверьте список поддерживаемых сайтов.
Зачем нужен архивисту
Значительная часть веб-контента — изображения: посты в Instagram, иллюстрации на DeviantArt и Pixiv, фото в Twitter/X, доски Pinterest. Браузерные расширения вроде SingleFile сохраняют одну страницу, а для массовой архивации галерей нужен специализированный инструмент.
gallery-dl решает задачи:
- скачать все фото из профиля (с метаданными);
- собрать доску Pinterest в один каталог;
- заархивировать иллюстрации автора с Pixiv;
- скачать блог Tumblr или сабреддит;
- сохранить описания, теги, даты — для последующей каталогизации.
Возможности
- Сотни поддерживаемых сайтов (около 390 в
supportedsites.mdна октябрь 2026 года, без учёта экземпляров Mastodon, booru-движков и т. п.). - Иерархия каталогов по шаблону (по умолчанию
категория/подкатегория/…). - Метаданные: JSON-файлы рядом с изображениями (
--write-metadata),info.jsonдля галереи (--write-info-json), теги в текстовых файлах (--write-tags). - Cookies и авторизация: файл cookies, загрузка cookies из браузера, логин и пароль, OAuth для части сайтов.
- Фильтрация: выражения на Python (
--filter), размер файла, дата поста, теги, диапазоны. - Пост-обработка: ZIP/CBZ, переименование, запуск команд, конвертация Ugoira (Pixiv) через FFmpeg.
- Учёт скачанного через
--download-archive. - Паузы и ограничения: задержки между загрузками и HTTP-запросами, ограничение скорости, обработка ответов 429.
Параллельной загрузки в несколько потоков в gallery-dl нет: файлы скачиваются последовательно.
Поддерживаемые платформы (выборка)
| Категория | Сайты |
|---|---|
| Соцсети | Twitter/X, Instagram, Tumblr, Bluesky, Mastodon, VK, Weibo |
| Арт-хостинги | Pixiv, DeviantArt, ArtStation, Behance, Newgrounds |
| Booru-галереи | Danbooru, Gelbooru, e621, Sankaku |
| Фото | Flickr, 500px, Imgur, Pinterest, Reddit |
| Имиджборды | 4chan, 8chan, 2ch |
| Комиксы | MangaDex, Webtoon |
| Другое | Patreon |
Полный список: supportedsites.md. Список меняется: экстракторы добавляются и удаляются (в том числе по жалобам правообладателей), а сайты меняют API.
Когда использовать
✅ Подходит для:
- массовой архивации изображений (авторы на Pixiv, доски Pinterest, сабреддиты);
- сбора изображений по списку URL;
- получения метаданных для каталогизации.
❌ Не подходит для:
- видео — используйте yt-dlp;
- архивации страниц целиком с комментариями и интерфейсом — используйте Browsertrix Crawler;
- скачивания HTML-страниц — используйте Wpull или Wget;
- загрузки файлов по одному URL — достаточно Wget или curl.
Установка
Через pip
python -m pip install -U gallery-dl
Или в изолированное окружение: pipx install gallery-dl.
Через пакетные менеджеры
# macOS / Linux (Homebrew)
brew install gallery-dl
# Linux (Snap)
snap install gallery-dl
# Windows
choco install gallery-dl
scoop install gallery-dl
Также есть готовые исполняемые файлы для Windows и Linux на странице релизов.
Из исходников (для разработчиков)
git clone https://codeberg.org/mikf/gallery-dl.git
cd gallery-dl
pip install -e .
Зависимости
- Python 3.8+ и requests — единственные обязательные зависимости.
- Необязательные: yt-dlp (видео в HLS/DASH), FFmpeg (конвертация Ugoira), PyYAML и toml (конфиги в YAML/TOML), SecretStorage (cookies из браузера в GNOME), brotli, zstandard.
Команды и параметры сверены с README и
gallery-dl --helpверсии 1.32.16 (октябрь 2026).
Использование
Скачать все по сты пользователя
# Twitter/X
gallery-dl "https://x.com/username"
# Instagram (обычно нужны cookies авторизованного аккаунта)
gallery-dl "https://www.instagram.com/username/"
# Pixiv (по ID автора; нужна авторизация через OAuth)
gallery-dl "https://www.pixiv.net/users/12345"
# Tumblr
gallery-dl "https://username.tumblr.com"
# Reddit (в 2026 году без OAuth не работает, см. ниже)
gallery-dl "https://www.reddit.com/r/subreddit"
Скачать одну запись
gallery-dl "https://www.instagram.com/p/POST_ID/"
gallery-dl "https://x.com/username/status/1234567890"
Скачать список URL из файла
# urls.txt — по одному URL на строку
gallery-dl --input-file urls.txt
# с пометкой (комментированием) успешно скачанных URL в файле
gallery-dl -I urls.txt
Фильтрация
# Только JPEG
gallery-dl --filter "extension in ('jpg', 'jpeg')" URL
# Только видео
gallery-dl --filter "extension in ('mp4', 'webm')" URL
# Не меньше 1920 пикселей по ширине (имена полей зависят от экстрактора)
gallery-dl --filter "width >= 1920" URL
# Только посты после даты и файлы не меньше 100 КБ
gallery-dl --date-after 2025-01-01 --filesize-min 100k URL
Какие поля доступны в --filter для конкретного сайта, показывает gallery-dl -K URL.
С архивом скачанных (не качать повторно)
gallery-dl --download-archive archive.sqlite3 URL
Архив — база SQLite: уже скачанные файлы при повторном запуске пропускаются.
С cookies (закрытые аккаунты)
# Из браузера
gallery-dl --cookies-from-browser firefox URL
gallery-dl --cookies-from-browser chrome URL
# Из файла в формате Netscape (cookies.txt)
gallery-dl --cookies cookies.txt URL
Паузы и ограничение скорости
# случайная пауза 2–5 секунд перед каждой загрузкой файла
gallery-dl --sleep 2-5 URL
# пауза 1–3 секунды между HTTP-запросами при извлечении данных
gallery-dl --sleep-request 1-3 URL
# ограничение скорости загрузки: 500 КБ/с
gallery-dl --limit-rate 500k URL
-r, --limit-rate ограничивает скорость загрузки в байтах в секунду, а не число запросов. Для бережной работы с сайтом используйте --sleep и --sleep-request.
С метаданными в JSON
gallery-dl --write-metadata --write-info-json URL
--write-metadata создаёт JSON-файл с метаданными для каждого скачанного файла, --write-info-json — общий info.json для галереи. Состав полей (автор, дата, теги, описание и т. д.) зависит от сайта.
Конфигурация
Где лежит конфиг
gallery-dl --config-status показывает, какие файлы проверяются. По умолчанию:
- Linux и macOS:
/etc/gallery-dl.conf,~/.config/gallery-dl/config.json,~/.gallery-dl.conf; - Windows:
%APPDATA%\gallery-dl\config.json,%USERPROFILE%\gallery-dl\config.json,%USERPROFILE%\gallery-dl.conf.
Формат по умолчанию — JSON. YAML и TOML можно подключить через --config-yaml FILE / --config-toml FILE (нужны PyYAML / toml). Создать базовый файл: gallery-dl --config-create.
Пример ~/.config/gallery-dl/config.json
Все настройки экстракторов, включая настройки отдельных сайтов, лежат внутри секции extractor:
{
"extractor": {
"base-directory": "~/Archives/gallery-dl",
"directory": ["{category}", "{subcategory}"],
"archive": "~/Archives/gallery-dl/archive.sqlite3",
"skip": true,
"sleep": "2-5",
"sleep-request": "1-3",
"user-agent": "Mozilla/5.0 (compatible; MyArchiveBot/1.0; +https://example.org/contact)",
"cookies": ["firefox"],
"twitter": {
"videos": true,
"retweets": false
},
"pixiv": {
"metadata": true
}
}
}
Все параметры описаны в configuration.rst, пример полного файла — gallery-dl.conf.
Авторизация через OAuth
OAuth обязателен для Pixiv и необязателен для DeviantArt, Flickr, SmugMug, Tumblr и экземпляров Mastodon. Для Reddit он в 2026 году фактически обязателен: запросы без OAuth Reddit блокирует, а доступ к API выдаёт по заявке, см. Reddit:
gallery-dl oauth:pixiv
gallery-dl oauth:flickr
gallery-dl oauth:reddit
Команда откроет страницу авторизации сайта и после подтверждения сохранит токен. Для Twitter/X OAuth не поддерживается — используйте cookies.
Сравнение с другими инструментами
| Инструмент | Сайтов | Метаданные | Фильтрация | Особенности |
|---|---|---|---|---|
| gallery-dl | сотни | ✅ JSON | ✅ выражения | последовательная загрузка |
| yt-dlp | тысячи (видео) | ✅ info.json | ✅ | для видео и аудио |
| PixivUtil2 | 1 (Pixiv) | ✅ | ✅ | только Pixiv |
| Hydrus Network | через загрузчики | ✅ (своя БД) | ✅ | локальный каталог с тегами и дедупликацией |
Когда gallery-dl лучше всех
- Нужна универсальность — один инструмент для десятков платформ.
- Важны метаданные (теги, автор, описание) в машиночитаемом виде.
- Нужна гибкая фильтрация (по размеру, типу, дате).
Когда лучше yt-dlp
- Цель — видео, а не изображения.
- Платформа — YouTube, VK Видео, Vimeo.
Когда лучше Hydrus Network
- Нужен локальный каталог с дедупликацией и тегами.
- Нужна работа в графическом интерфейсе (метки, коллекции, поиск).
Best practices
1. Используйте архив скачанных
gallery-dl --download-archive archive.sqlite3 URL
Это главная практика: без архива при повторном запуске придётся заново проверять каждый файл, а при изменении шаблона имён — качать заново.
2. Сохраняйте метаданные
gallery-dl --write-metadata --write-info-json URL
Без описаний, тегов, автора и даты коллекция изображений — просто набор файлов.