gallery dl
1.27.7
Gallery-dl — это программа командной строки для загрузки галерей и коллекций изображений с нескольких хостингов изображений (см. Поддерживаемые сайты). Это кроссплатформенный инструмент со множеством опций конфигурации и мощными возможностями именования файлов.
Содержание
Зависимости
Необязательный
Установка
Пип
Автономный исполняемый файл
Ночные сборки
Щелчок
Шоколадный
Совок
Домашнее пиво
МакПортс
Докер
Использование
Примеры
Конфигурация
Документация
Локации
Аутентификация
Имя пользователя и пароль
Файлы cookie
OAuth
Питон 3.4+
Запросы
yt-dlp или youtube-dl: загрузка видео HLS/DASH, интеграция ytdl
FFmpeg: преобразование Pixiv Ugoira
mkvmerge: точные таймкоды кадров Угойры
PySocks: поддержка прокси SOCKS.
brotli или brotlicffi: поддержка сжатия Brotli.
zstandard: поддержка сжатия Zstandard.
PyYAML: поддержка файла конфигурации YAML.
toml: поддержка файла конфигурации TOML для Python <3.11.
SecretStorage: пароли ключей GNOME для --cookies-from-browser
Стабильные выпуски галереи-dl распространяются через PyPI и могут быть легко установлены или обновлены с помощью pip:
python3 -m pip install -U галерея-dl
Установить последнюю версию для разработчиков непосредственно с GitHub также можно с помощью pip:
python3 -m pip install -U -I --no-deps --no-cache-dir https://github.com/mikf/gallery-dl/archive/master.tar.gz
Примечание. Пользователи Windows должны использовать py -3 вместо python3 .
Рекомендуется использовать последнюю версию pip, включая необходимые пакеты setuptools wheel . Чтобы убедиться, что эти пакеты обновлены, запустите
python3 -m pip install --upgrade колесо настройки pip
Предварительно созданные исполняемые файлы с интерпретатором Python и необходимые пакеты Python доступны для
Windows (требуется распространяемый пакет Microsoft Visual C++ (x86))
Линукс
Исполняемые файлы, созданные на основе последнего коммита, можно найти по адресу
https://github.com/gdl-org/builds/releases
Пользователи Linux, использующие дистрибутив, поддерживаемый Snapd, могут установить Gallery-dl из Snap Store:
оснастка установки галереи-dl
Пользователи Windows, у которых установлен Chocolatey, могут установить Gallery-dl из репозитория пакетов сообщества Chocolatey:
choco установить галерею-dl
Gallery-dl также доступен в «основном» сегменте Scoop для пользователей Windows:
Scoop установить галерею-dl
Для пользователей macOS или Linux, использующих Homebrew:
варить установку галереи-dl
Для пользователей macOS с MacPorts:
порт sudo установить галерею-dl
Использование Dockerfile в репозитории:
git-клон https://github.com/mikf/gallery-dl.gitcd Gallery-dl/ docker build -t Gallery-dl:latest.
Получение образа из Docker Hub:
docker pull mikf123/gallery-dl Тег Docker mikf123/gallery-dl Gallery-dl
Извлечение образа из реестра контейнеров GitHub:
докер вытащить ghcr.io/mikf/gallery-dl Тег docker ghcr.io/mikf/gallery-dl Gallery-dl
Для запуска контейнера вам, вероятно, потребуется прикрепить несколько каталогов на хосте, чтобы файл конфигурации и загрузки могли сохраняться при каждом запуске.
Обязательно загрузите ссылку на пример файла конфигурации из репозитория и поместите ее в расположение смонтированного тома, либо коснитесь там пустого файла.
Если вы присвоили контейнеру другой тег или используете podman, обязательно настройте его. Если вы не уверены, запустите docker image ls , чтобы проверить имя.
Это приведет к удалению контейнера после каждого использования, поэтому у вас всегда будет новая среда для его запуска. Если вы настроите конвейер ci-cd для автоматической сборки контейнера, вы также можете добавить флаг --pull=newer , чтобы при его запуске докер проверял, есть ли более новый контейнер, и загружал его перед запуском.
docker run --rm -v $HOME/Downloads/:/gallery-dl/ -v $HOME/.config/gallery-dl/gallery-dl.conf:/etc/gallery-dl.conf -it Gallery-dl: последний
Вы также можете добавить в свою оболочку псевдоним «gallery-dl» или создать простой сценарий bash и поместить его где-нибудь в $PATH, чтобы он служил прокладкой для этой команды.
Чтобы использовать Gallery-dl, просто вызовите его, указав URL-адреса, с которых вы хотите загрузить изображения:
галерея-dl [ОПЦИИ]... URL-адреса...
Используйте gallery-dl --help или посетите docs/options.md для получения полного списка всех параметров командной строки.
Загрузка изображений; в данном случае от danbooru через поиск по тегу «bonocho»:
галерея-dl "https://danbooru.donmai.us/posts?tags=bonocho"
Получите прямой URL-адрес изображения с сайта, поддерживающего аутентификацию по имени пользователя и паролю:
галерея-dl -g -u "<имя пользователя>" -p "<пароль>" "https://twitter.com/i/web/status/604341487988576256"
Фильтровать главы манги по номеру главы и языку:
галерея-дл --chapter-filter "10 <= глава < 20" -o "lang=fr" "https://mangadex.org/title/59793dd0-a2d8-41a2-9758-8197287a8539"
Найдите на удаленном ресурсе URL-адреса и загрузите с них изображения:
(URL-адреса, для которых не найден экстрактор, будут игнорироваться)
галерея-dl "r: https://pastebin.com/raw/FLwrCYsT"
Если адрес сайта нестандартен для его экстрактора, вы можете добавить к URL-адресу имя экстрактора, чтобы принудительно использовать конкретный экстрактор:
галерея-dl "tumblr:https://sometumblrblog.example"
Файлы конфигурации для галереи-dl используют формат файлов на основе JSON.
Список всех доступных параметров конфигурации и их описания можно найти по адресу https://gdl-org.github.io/docs/configuration.html.
Файл конфигурации по умолчанию, в котором для доступных параметров установлены значения по умолчанию, см. в docs/gallery-dl.conf.
Комментированный пример с более сложными настройками и использованием опций см. в docs/gallery-dl-example.conf.
Gallery-dl ищет файлы конфигурации в следующих местах:
Окна:
( %USERPROFILE% обычно относится к домашнему каталогу пользователя, т.е. C:Users<username> )
%APPDATA%gallery-dlconfig.json
%USERPROFILE%gallery-dlconfig.json
%USERPROFILE%gallery-dl.conf
Linux, macOS и т. д.:
/etc/gallery-dl.conf
${XDG_CONFIG_HOME}/gallery-dl/config.json
${HOME}/.config/gallery-dl/config.json
${HOME}/.gallery-dl.conf
При запуске в качестве исполняемого файла галерея-dl также будет искать файл gallery-dl.conf в том же каталоге, что и указанный исполняемый файл.
Одновременно можно использовать более одного файла конфигурации. В этом случае любые значения из файлов после первого будут объединены с уже загруженными настройками и потенциально переопределят предыдущие.
Некоторые экстракторы требуют, чтобы вы предоставили действительные учетные данные для входа в виде пары имени пользователя и пароля. Это необходимо для nijie и необязательно для aryion , danbooru , e621 , exhentai , idolcomplex , imgbb , inkbunny , mangadex , mangoxo , pillowfort , sankaku , subscribestar , tapas , tsumino , twitter и zerochan .
Вы можете установить необходимую информацию в файле конфигурации.
{ "extractor": { "twitter": { "username": "<имя пользователя>", "пароль": "<пароль>"
}
}
} или вы можете предоставить их напрямую через -u/--username и -p/--password или через параметры командной строки -o/--option
галерея-dl -u "<имя пользователя>" -p "<пароль>" "URL"gallery-dl -o "username=<имя пользователя>" -o "пароль=<пароль>" "URL"
Для сайтов, на которых вход с использованием имени пользователя и пароля невозможен из-за CAPTCHA или чего-то подобного или еще не реализован, вы можете использовать файлы cookie из сеанса входа в браузер и ввести их в Gallery-dl .
Это можно сделать с помощью опции cookie в вашем файле конфигурации, указав
путь к файлу cookie.txt в формате Mozilla/Netscape, экспортированному надстройкой браузера
(например, получить файл cookie.txt ЛОКАЛЬНО для Chrome, экспортировать файлы cookie для Firefox)
список пар имя-значение, собранный с помощью инструментов веб-разработчика вашего браузера
(в Chrome, в Firefox)
имя браузера, из которого извлекаются файлы cookie
(поддерживаются браузеры на базе Chromium, Firefox и Safari)
Например:
{ "extractor": { "instagram": { "cookies": "$HOME/path/to/cookies.txt"
}, "patreon": { "cookies": { "session_id": "K1T57EKu19TR49C51CDjOJoXNQLF7VbdVOiBrC9ye0a"
}
}, "twitter": { "cookies": ["firefox"]
}
}
} Вы также можете указать файл cookie.txt с помощью параметра командной строки --cookies
или браузер для извлечения файлов cookie с помощью --cookies-from-browser :
галерея-dl --cookies "$HOME/path/to/cookies.txt" "URL"gallery-dl --cookies-from-browser firefox "URL"
галерея-dl поддерживает аутентификацию пользователей через OAuth для некоторых экстракторов. Это необходимо для pixiv и необязательно для экземпляров deviantart , flickr , reddit , smugmug , tumblr и mastodon .
Привязка вашей учетной записи к Gallery-dl дает ей возможность отправлять запросы от имени вашей учетной записи и дает ей доступ к ресурсам, которые в противном случае были бы недоступны для публичного пользователя.
Для этого начните с вызова его с oauth:<sitename> в качестве аргумента. Например:
галерея-dl oauth: flickr
Вас перенаправят на страницу авторизации сайта и попросят предоставить доступ для чтения галереи-dl . Авторизуйте его, и вам будет показан один или несколько «токенов», которые следует добавить в ваш файл конфигурации.
Чтобы пройти аутентификацию с помощью экземпляра mastodon , запустите Gallery-dl с oauth:mastodon:<instance> в качестве аргумента. Например:
галерея-dl oauth:mastodon:pawoo.net галерея-dl oauth:mastodon:https://mastodon.social/
