https://github.com/ultralytics/google-images-download
Google/Bing Images Web Downloader
https://github.com/ultralytics/google-images-download
bing-images-downloader download google-image-downloader google-image-search google-images-downloader images scrape scraper
Last synced: 3 months ago
JSON representation
Google/Bing Images Web Downloader
- Host: GitHub
- URL: https://github.com/ultralytics/google-images-download
- Owner: ultralytics
- License: agpl-3.0
- Fork: true (hardikvasa/google-images-download)
- Created: 2020-02-25T20:15:15.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2024-08-26T14:00:39.000Z (10 months ago)
- Last Synced: 2024-08-26T16:28:01.384Z (10 months ago)
- Topics: bing-images-downloader, download, google-image-downloader, google-image-search, google-images-downloader, images, scrape, scraper
- Language: Python
- Homepage: https://ultralytics.com
- Size: 339 KB
- Stars: 297
- Watchers: 5
- Forks: 85
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🚀 Introduction
Welcome to the Bing image scraping tool, updated and maintained by Ultralytics. This repository contains updated code originally from [https://github.com/hardikvasa/google-images-download](https://github.com/hardikvasa/google-images-download), enabling users to efficiently scrape and download images from Bing for various applications like machine learning, data analysis, or personal projects.
[](https://github.com/ultralytics/google-images-download/actions/workflows/format.yml) 
## 🐳 Docker Run
For details, visit docker github repository: google-images-download-by-docker
```bash
$ docker run -d -p 80:80 --name image_searcher saitamatechno/google_images_download:v1.0
```
## 📋 Requirements
To use this software, ensure you have Python 3.8 or later and all the necessary dependencies installed. Dependencies can be installed by running the following command in your terminal:
```bash
$ pip install -r requirements.txt
```
The `requirements.txt` file is located [here](https://github.com/ultralytics/google-images-download/blob/main/requirements.txt), which includes `selenium` among others.
## ⚙️ Installation
To set up the image scraper on your machine, clone this repository and install the dependencies as shown below:
```bash
$ git clone https://github.com/ultralytics/google-images-download
$ cd google-images-download
$ pip install -r requirements.txt
```
## 🖥️ How to Run
Run the image scraper following these steps:
1. Ensure Google Chrome is installed on your machine. If not, download and install from [here](https://www.google.com/chrome/).
2. Download and update chromedriver corresponding to your version of Chrome [here](https://developer.chrome.com/docs/chromedriver/).
3. Execute the script. Use the `--url` parameter to download images from a specific Bing URL or the `--search` parameter for Bing search terms. By default, the images will be saved in the `./images` directory. Note that any images that cause errors will be skipped during the download process.
Example usage to download images using a URL:
```bash
$ python3 bing_scraper.py --url 'https://www.bing.com/images/search?q=flowers' --limit 10 --download --chromedriver /path/to/your/chromedriver
```
Example usage to download images using search terms:
```bash
$ python3 bing_scraper.py --search 'honeybees on flowers' --limit 10 --download --chromedriver /path/to/your/chromedriver
# Expect output logs showing the download process and any errors encountered.
```
## 📜 Citing the Project
To acknowledge the use of this software in your works, please reference the original repository, which can be found [here](https://github.com/hardikvasa/google-images-download).
## 🤝 Contributing
We warmly welcome contributions from the community. Your support and contributions are invaluable in making this open-source software greater. Whether you've found a bug, have a feature suggestion, or want to contribute code, please have a look at the [Contributing Guide](https://docs.ultralytics.com/help/contributing/). Furthermore, take a moment to fill out our [Survey](https://www.ultralytics.com/survey?utm_source=github&utm_medium=social&utm_campaign=Survey); your feedback helps us improve continuously. A big thank you 🙏 goes to all the contributors!
## 🔏 License
We offer two types of licensing to cater for a variety of use cases:
### AGPL-3.0 License
This license is ideal for individuals or teams working on non-commercial projects. It encourages openness, collaboration, and the sharing of knowledge and improvements. See the [LICENSE](https://github.com/ultralytics/ultralytics/blob/main/LICENSE) for all the details.
### Enterprise License
For commercial applications, the Enterprise License provides a solution that enables the integration of Ultralytics software into your products without the restrictions of AGPL-3.0. This license is suited for commercial offerings where the specifics of AGPL-3.0 are not appropriate. If you are interested in an enterprise solution, please reach out to us for more information through [Ultralytics Licensing](https://www.ultralytics.com/license).
## 📬 Contact
If you encounter any issues or have features you'd like to request, please visit our [GitHub Issues](https://github.com/ultralytics/google-images-download/issues) page. For general discussions, questions, or to connect with the community, join our vibrant [Discord](https://discord.com/invite/ultralytics) community.
```