ultralytics / google-images-download

Google/Bing Images Web Downloader

🚀 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, enabling users to efficiently scrape and download images from Bing for various applications like machine learning, data analysis, or personal projects.

📋 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:

$ pip install -r requirements.txt

The requirements.txt file is located here, 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:

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

2. Download and update chromedriver corresponding to your version of Chrome here.

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:

$ 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:

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

🤝 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. Furthermore, take a moment to fill out our 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 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.

📬 Contact

If you encounter any issues or have features you'd like to request, please visit our GitHub Issues page. For general discussions, questions, or to connect with the community, join our vibrant Discord community.

```