从多个图像宿主站点下载图像库和集合的命令行程序
gallery-dl的Python项目详细描述
gallery dl是一个命令行程序,用于下载图像库和 -来自多个图像宿主站点的集合(请参见Supported Sites)。 它是一个跨平台的工具,有许多配置选项 以及强大的文件命名功能。
安装
PIP
gallery dl的稳定版本分布在PyPI上,可以是 使用pip:
轻松安装或升级$ pip install --upgrade gallery-dl
直接从github安装最新的dev版本可以使用 pip以及:
$ pip install --upgrade https://github.com/mikf/gallery-dl/archive/master.zip
确保用于pip的python解释器是3.4或更高版本。
您可能必须使用pip3
或python3 -m pip
取决于系统的默认值。
来源
通过
导航到相应的目录并运行setup.py
文件。
$ wget https://github.com/mikf/gallery-dl/archive/master.zip $ unzip master.zip # or $ git clone https://github.com/mikf/gallery-dl.git $ cd gallery-dl $ python setup.py install
用法
要使用gallery dl只需使用要下载图像的url调用它 发件人:
$ gallery-dl [OPTION]... URL...
另请参见gallery-dl --help
。
示例
下载图像;在本例中,可以从danbooru通过标记搜索“bonocho”:
$ gallery-dl http://danbooru.donmai.us/posts?tags=bonocho
从需要身份验证的站点获取图像的直接url:
$ gallery-dl -g -u <username> -p <password> http://seiga.nicovideo.jp/seiga/im3211703
$ gallery-dl r:https://pastebin.com/raw/FLwrCYsT
配置
gallery dl的配置文件使用基于json的文件格式。
gallery dl在以下位置搜索配置文件:
Linux | Windows |
|
|
(%USERPROFILE%通常指用户的主目录, 即C:\Users\<username>\)
以后配置文件中的值将覆盖以前的值。
身份验证
用户名和密码
一些提取器要求您以以下形式提供有效的登录凭据 用户名和密码对。这是必要的 pixiv、nijie和seiga 和可选(但强烈建议)用于 danbooru,exhentai,idolcomplex,instagram, luscious、sankaku、tsumino和twitter。
您可以在配置文件中设置必要的信息 (参见gallery-dl.conf)
{ "extractor": { ... "pixiv": { "username": "<username>", "password": "<password>" } ... } }
或者你可以直接通过
-u/--username
和-p/--password
或通过
-o/--option
命令行选项
$ gallery-dl -u <username> -p <password> URL $ gallery-dl -o username=<username> -o password=<password> URL
OAuth
gallery dl支持通过OAuth进行用户身份验证 deviantart,flickr,reddit,smugmug和tumblr。 这是完全可选的,但是可以授予gallery dl能力 代表您的帐户发出请求并使其能够访问资源 否则将是UNA可供公共用户使用。
要将您的帐户链接到gallery dl,请首先使用 oauth:<site-name>作为参数。例如:
$ gallery-dl oauth:flickr
您将被发送到网站的授权页,并被要求授予读取权限 访问gallery dl。授权后,将显示一个或多个 “令牌”,应该添加到配置文件中。