Documents: imagedl.readthedocs.io
- 2025-10-22: Released pyimagedl v0.1.7 — refactor codes for google and DuckDuckGo, fix base module requests bugs, and add sogou image search.
- 2025-10-22: Released pyimagedl v0.1.6 — Fix serpapisearch bugs, more robust code structure, add DuckDuckGo image search.
- 2025-10-21: Released pyimagedl v0.1.5 — Fix maintain session bugs, support pixabay and yandex image search.
- 2025-10-20: Released pyimagedl v0.1.4 — Add a deduplication feature and support 360 image search.
- 2025-10-19: Released pyimagedl v0.1.3 — code cleanup, deprecated/invalid functions removed, new functions added.
imagedl lets you search for and download images from specific websites. If you find it useful, please consider starring the repository to follow updates—thank you for your support!
| ImageClient_EN | ImageClient_CN | Search | Download | Code Snippet |
|---|---|---|---|---|
| BaiduImageClient | 百度图片 | ✓ | ✓ | baidu.py |
| BingImageClient | 必应图片 | ✓ | ✓ | bing.py |
| GoogleImageClient | 谷歌图片 | ✓ | ✓ | google.py |
| I360ImageClient | 360图片 | ✓ | ✓ | i360.py |
| PixabayImageClient | Pixabay图片 | ✓ | ✓ | pixabay.py |
| YandexImageClient | Yandex图片 | ✓ | ✓ | yandex.py |
| DuckduckgoImageClient | DuckDuckGo图片 | ✓ | ✓ | duckduckgo.py |
| SogouImageClient | 搜狗图片 | ✓ | ✓ | sogou.py |
# from pip
pip install pyimagedl
# from github repo method-1
pip install git+https://github.com/CharlesPikachu/imagedl.git@main
# from github repo method-2
git clone https://github.com/CharlesPikachu/imagedl.git
cd imagedl
python setup.py installAfter a successful installation, you can run the snippet below,
from imagedl import imagedl
image_client = imagedl.ImageClient(image_source='BaiduImageClient')
image_client.startcmdui()Or just run imagedl (maybe imagedl --help to show usage information) from the terminal.
For class ImageClient, the acceptable arguments include,
image_source(str, default:'BaiduImageClient'): The image search and download source, including['BaiduImageClient', 'BingImageClient', 'GoogleImageClient', 'I360ImageClient', 'PixabayImageClient', 'YandexImageClient', 'DuckduckgoImageClient', 'SogouImageClient'].init_image_client_cfg(dict, default:{}): Client initialization configuration such as{'work_dir': 'images', 'max_retries': 5}.search_limits(int, default:1000): Scale of image downloads.num_threadings(int, default:5): Number of threads used.request_overrides(dict, default:{}): Requests.get kwargs such as{'headers': {'User-Agent': xxx}, 'proxies': {}}.
The demonstration is as follows,
- Games: Create interesting games by pure python.
- DecryptLogin: APIs for loginning some websites by using requests.
- Musicdl: A lightweight music downloader written by pure python.
- Videodl: A lightweight video downloader written by pure python.
- Pytools: Some useful tools written by pure python.
- PikachuWeChat: Play WeChat with itchat-uos.
- Pydrawing: Beautify your image or video.
- ImageCompressor: Image compressors written by pure python.
- FreeProxy: Collecting free proxies from internet.
- Paperdl: Search and download paper from specific websites.
- Sciogovterminal: Browse "The State Council Information Office of the People's Republic of China" in the terminal.
- CodeFree: Make no code a reality.
- DeepLearningToys: Some deep learning toys implemented in pytorch.
- DataAnalysis: Some data analysis projects in charles_pikachu.
- Imagedl: Search and download images from specific websites.
- Pytoydl: A toy deep learning framework built upon numpy.
- NovelDL: Search and download novels from some specific websites.
Charles的皮卡丘 (Charles_pikachu)
