Metadata-Version: 2.1
Name: pyimagedl
Version: 0.1.2
Summary: Imagedl: Search and download images from specific websites
Home-page: https://github.com/CharlesPikachu/imagedl
Author: Charles
Author-email: charlesblwx@gmail.com
License: Apache License 2.0
Platform: UNKNOWN
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: alive-progress
Requires-Dist: pyfreeproxy
Requires-Dist: user-agent
Requires-Dist: beautifulsoup4
Requires-Dist: lxml

<div align="center">
  <img src="./docs/logo.png" width="600"/>
</div>
<br />

[![docs](https://img.shields.io/badge/docs-latest-blue)](https://imagedl.readthedocs.io/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pyimagedl)](https://pypi.org/project/pyimagedl/)
[![PyPI](https://img.shields.io/pypi/v/pyimagedl)](https://pypi.org/project/pyimagedl)
[![license](https://img.shields.io/github/license/CharlesPikachu/imagedl.svg)](https://github.com/CharlesPikachu/imagedl/blob/master/LICENSE)
[![PyPI - Downloads](https://pepy.tech/badge/pyimagedl)](https://pypi.org/project/pyimagedl/)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/pyimagedl?style=flat-square)](https://pypi.org/project/pyimagedl/)
[![issue resolution](https://isitmaintained.com/badge/resolution/CharlesPikachu/imagedl.svg)](https://github.com/CharlesPikachu/imagedl/issues)
[![open issues](https://isitmaintained.com/badge/open/CharlesPikachu/imagedl.svg)](https://github.com/CharlesPikachu/imagedl/issues)

Documents: https://imagedl.readthedocs.io/


# Imagedl

```
Search and download images from specific websites.
You can star this repository to keep track of the project if it's helpful for you, thank you for your support.
```


# Support List

|  Source_EN                          |  Source_CN       |   Support Search?  |  Support Download?   |
|  :----:                             |  :----:          |   :----:           |  :----:              |
|  [baidu](https://baidu.com/)        |  百度图片        |   ✓                |  ✓                   |
|  [bing](https://cn.bing.com/)       |  必应图片        |   ✓                |  ✓                   |
|  [google](https://www.google.com/)  |  谷歌图片        |   ✓                |  ✓                   |


# Install

#### Pip install

```
run "pip install pyimagedl"
```

#### Source code install

```sh
(1) Offline
Step1: git clone https://github.com/CharlesPikachu/imagedl.git
Step2: cd imagedl -> run "python setup.py install"
(2) Online
run "pip install git+https://github.com/CharlesPikachu/imagedl.git@master"
```


# Quick Start

#### Run by leveraging the API

```python
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')
```

#### Run by leveraging compiled file

```
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.
```


# Screenshot

![img](./docs/screenshot.gif)


# Projects in Charles_pikachu

- [Games](https://github.com/CharlesPikachu/Games): Create interesting games by pure python.
- [DecryptLogin](https://github.com/CharlesPikachu/DecryptLogin): APIs for loginning some websites by using requests.
- [Musicdl](https://github.com/CharlesPikachu/musicdl): A lightweight music downloader written by pure python.
- [Videodl](https://github.com/CharlesPikachu/videodl): A lightweight video downloader written by pure python.
- [Pytools](https://github.com/CharlesPikachu/pytools): Some useful tools written by pure python.
- [PikachuWeChat](https://github.com/CharlesPikachu/pikachuwechat): Play WeChat with itchat-uos.
- [Pydrawing](https://github.com/CharlesPikachu/pydrawing): Beautify your image or video.
- [ImageCompressor](https://github.com/CharlesPikachu/imagecompressor): Image compressors written by pure python.
- [FreeProxy](https://github.com/CharlesPikachu/freeproxy): Collecting free proxies from internet.
- [Paperdl](https://github.com/CharlesPikachu/paperdl): Search and download paper from specific websites.
- [Sciogovterminal](https://github.com/CharlesPikachu/sciogovterminal): Browse "The State Council Information Office of the People's Republic of China" in the terminal.
- [CodeFree](https://github.com/CharlesPikachu/codefree): Make no code a reality.
- [DeepLearningToys](https://github.com/CharlesPikachu/deeplearningtoys): Some deep learning toys implemented in pytorch.
- [DataAnalysis](https://github.com/CharlesPikachu/dataanalysis): Some data analysis projects in charles_pikachu.
- [Imagedl](https://github.com/CharlesPikachu/imagedl): Search and download images from specific websites.


# More

#### WeChat Official Accounts

*Charles_pikachu*  
![img](./docs/pikachu.jpg)

