Imagedl中文文档

项目声明

本项目仅供python爱好者学习使用, 禁止用于商业用途, 希望大家合理利用该项目🙂

安装imagedl

环境配置

操作系统: Linux or macOS or Windows
Python版本: Python3.6+

PIP安装(推荐)

在终端运行如下命令即可(请保证python在环境变量中):

pip install pyimagedl --upgrade

源代码安装

1.在线安装

运行如下命令即可在线安装:

pip install git+https://github.com/CharlesPikachu/imagedl.git@master

2.离线安装

利用如下命令下载imagedl源代码到本地:

git clone https://github.com/CharlesPikachu/imagedl.git

接着, 切到imagedl目录下:

cd imagedl

最后运行如下命令进行安装:

python setup.py install

快速开始

API调用

示例代码如下:

from imagedl import imagedl

config = {
    'savedir': 'outputs',
    'auto_set_proxies': True,
    'auto_set_headers': True,
    'search_limits': 1000,
    'num_threadings': 5,
}
client = imagedl.imagedl(config=config)
client.run('baidu')

config中的参数解释如下:

savedir: 图片保存文件夹;
auto_set_proxies: 本地IP因为请求过于频繁被目标服务器禁止访问后, 是否自带开启代理, 代理是用freeproxy从网上抓取的;
auto_set_headers: 请求过程中是否自动更好请求头;
search_limits: 下载的图片数量;
num_threadings: 使用的线程数量。

run函数支持的参数如下:

target_src: 使用的图片源, 目前支持”bing”, “baidu”和”google”。

编译调用

pip安装之后, 环境变量中会自动生成imagedl.exe文件, 只需要在终端直接输入imagedl即可调用, 使用方式如下:

Usage: imagedl [OPTIONS]

Options:
  --version                  Show the version and exit.
  -k, --keyword TEXT         想要搜索下载的图片关键字, 若不指定, 则进入imagedl终端版
  -s, --savedir TEXT         下载的图片的保存路径
  -t, --target TEXT          指定图片搜索下载的平台, 例如"baidu"
  -l, --limits INTEGER       下载的图片数量
  -n, --nthreadings INTEGER  使用的线程数量
  --help                     Show this message and exit.

例如:

imagedl -k 狗狗 -s dogs -t baidu -l 1000

效果如下:

开发日志

2022-03-22

版本号: v0.1.0-0.1.1,
更新内容: 支持百度, 必应和谷歌三种图片源。

2022-03-24

版本号: v0.1.2,
更新内容: 添加作者信息。

关于作者

学生党, 主要研究方向是计算机视觉, 顺便对信息安全感兴趣。

我的个人微信公众号是: Charles_pikachu (欢迎搜索关注，或者搜”Charles的皮卡丘”)

我的Github账号是: https://github.com/CharlesPikachu (欢迎搜索关注)

我的知乎账号是: https://www.zhihu.com/people/charles_pikachu (欢迎搜索关注)

我的B站账号是: https://space.bilibili.com/406756145 (欢迎搜索关注)

个人邮箱: charlesblwx@gmail.com