# Image Downloader
---
> Download related images through search engines using keywords, suitable for dataset collection in deep learning, machine learning, and similar scenarios.
[中文介绍](https://github.com/2635064692/image-downloader/blob/main/README.md)
[English Introduction](https://github.com/2635064692/image-downloader/blob/main/README-en.md)
## Introduction
- This tool supports image search on multiple search engines, including Google, Bing, Baidu, etc. (see the support roadmap for details).
- Supports downloading high-quality images directly from Google’s original site, which can be applied to dataset collection for fields like machine learning and deep learning.
- Retrieves original website links for the searched images and downloads images from the original sites.
- Similar to the functionality of `google-images-download`, but more practical and enhanced.
- Supports [java version](https://github.com/2635064692/Image-Downloader-java)
- Supports [python version](https://github.com/2635064692/image-downloader)
## Usage
- Install dependencies
```shell
pip install image-downloader-ml
```
- Usage example
```shell
image-downloader-ml -l 20 -o "./output" -k "Broken traffic guardrail" -plt 5 -kf "./sample_config.json"
```
## Support Plan
- [ √ ] Google Image Search
- [ √ ] Bing Image Search
- [ √ ] Baidu Image Search
## Disclaimer
This program allows you to download a large number of images from search engines. Please do not download or use any images that violate copyright laws. Google Images is a search engine that indexes images and allows you to locate them. It does not create its own images and therefore does not own any copyrights. The original creators of the images hold the copyright.
In regions and countries where images are published, the images are automatically protected by copyright laws, even if there is no explicit copyright notice. Unless under "fair use" exceptions, you may not copy copyrighted images without the owner's permission, or you may face legal consequences such as warnings, cease-and-desist letters, or copyright lawsuits. Please use with caution! This script/code is intended for educational purposes only.
Raw data
{
"_id": null,
"home_page": "https://github.com/2635064692/image-downloader",
"name": "image-downloader-ml",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "google bing baidu images download image-dataset terminal command-line",
"author": "Hai Zh",
"author_email": "peterzh1998@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/9c/c9/fb83d464527597f4c038e77af35ef5a43e32d9ae7dc21ad6b3bcc59246ee/image_downloader_ml-1.0.9.tar.gz",
"platform": null,
"description": "# Image Downloader\r\r\n\r\r\n---\r\r\n> Download related images through search engines using keywords, suitable for dataset collection in deep learning, machine learning, and similar scenarios.\r\r\n\r\r\n\r\r\n[\u4e2d\u6587\u4ecb\u7ecd](https://github.com/2635064692/image-downloader/blob/main/README.md)\r\r\n\r\r\n[English Introduction](https://github.com/2635064692/image-downloader/blob/main/README-en.md)\r\r\n## Introduction\r\r\n- This tool supports image search on multiple search engines, including Google, Bing, Baidu, etc. (see the support roadmap for details).\r\r\n- Supports downloading high-quality images directly from Google\u2019s original site, which can be applied to dataset collection for fields like machine learning and deep learning.\r\r\n- Retrieves original website links for the searched images and downloads images from the original sites.\r\r\n- Similar to the functionality of `google-images-download`, but more practical and enhanced.\r\r\n- Supports [java version](https://github.com/2635064692/Image-Downloader-java) \r\r\n- Supports [python version](https://github.com/2635064692/image-downloader)\r\r\n## Usage\r\r\n- Install dependencies\r\r\n ```shell\r\r\n pip install image-downloader-ml\r\r\n ```\r\r\n- Usage example\r\r\n ```shell\r\r\n image-downloader-ml -l 20 -o \"./output\" -k \"Broken traffic guardrail\" -plt 5 -kf \"./sample_config.json\"\r\r\n ```\r\r\n\r\r\n## Support Plan\r\r\n\r\r\n- [ \u221a ] Google Image Search\r\r\n- [ \u221a ] Bing Image Search\r\r\n- [ \u221a ] Baidu Image Search\r\r\n\r\r\n\r\r\n## Disclaimer\r\r\n\r\r\nThis program allows you to download a large number of images from search engines. Please do not download or use any images that violate copyright laws. Google Images is a search engine that indexes images and allows you to locate them. It does not create its own images and therefore does not own any copyrights. The original creators of the images hold the copyright.\r\r\n\r\r\nIn regions and countries where images are published, the images are automatically protected by copyright laws, even if there is no explicit copyright notice. Unless under \"fair use\" exceptions, you may not copy copyrighted images without the owner's permission, or you may face legal consequences such as warnings, cease-and-desist letters, or copyright lawsuits. Please use with caution! This script/code is intended for educational purposes only.\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Image download tools used in machine learning, deep learning.",
"version": "1.0.9",
"project_urls": {
"Download": "https://github.com/2635064692/image-downloader/releases/download/1.0.9/image_downloader_ml-1.0.9.tar.gz",
"Homepage": "https://github.com/2635064692/image-downloader"
},
"split_keywords": [
"google",
"bing",
"baidu",
"images",
"download",
"image-dataset",
"terminal",
"command-line"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9cc9fb83d464527597f4c038e77af35ef5a43e32d9ae7dc21ad6b3bcc59246ee",
"md5": "db5e3c7bd4276697118cc9295e2007d1",
"sha256": "570bb9c0ad6bcbb21fbe677a8652b3097450d617d1df9fc13bed52ffb5705f05"
},
"downloads": -1,
"filename": "image_downloader_ml-1.0.9.tar.gz",
"has_sig": false,
"md5_digest": "db5e3c7bd4276697118cc9295e2007d1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 18078,
"upload_time": "2025-01-21T03:37:11",
"upload_time_iso_8601": "2025-01-21T03:37:11.147226Z",
"url": "https://files.pythonhosted.org/packages/9c/c9/fb83d464527597f4c038e77af35ef5a43e32d9ae7dc21ad6b3bcc59246ee/image_downloader_ml-1.0.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-21 03:37:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "2635064692",
"github_project": "image-downloader",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "selenium",
"specs": [
[
"~=",
"4.24.0"
]
]
},
{
"name": "webdriver_manager",
"specs": []
},
{
"name": "setuptools",
"specs": [
[
"~=",
"75.1.0"
]
]
},
{
"name": "requests",
"specs": [
[
"~=",
"2.32.3"
]
]
},
{
"name": "pillow",
"specs": [
[
"~=",
"11.0.0"
]
]
},
{
"name": "beautifulsoup4",
"specs": [
[
"~=",
"4.12.3"
]
]
}
],
"lcname": "image-downloader-ml"
}
JSON
