You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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 Bingfor various applications like machine learning, data analysis, or personal projects.
5
+
Welcome to the Bing Image Scraper, a tool updated and maintained by Ultralytics. This repository provides enhanced code, originally based on the [google-images-download](https://github.com/hardikvasa/google-images-download) project by hardikvasa, specifically adapted for scraping images from Bing. It allows users to efficiently download images for various purposes, such as building datasets for [machine learning](https://www.ultralytics.com/glossary/machine-learning-ml), performing [data analysis](https://en.wikipedia.org/wiki/Data_analysis), or curating collections for personal projects. Explore more tools and models at [Ultralytics](https://www.ultralytics.com/).
For details, visit docker github repository: <ahref="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/SaitamaTechno/google-images-download-by-docker">google-images-download-by-docker</a><br>
14
+
For easy deployment using Docker, visit the dedicated GitHub repository: [google-images-download-by-docker](https://github.com/SaitamaTechno/google-images-download-by-docker).
15
+
16
+
You can run the scraper within a Docker container using the following command:
13
17
14
18
```bash
15
-
$ docker run -d -p 80:80 --name image_searcher saitamatechno/google_images_download:v1.0
19
+
docker run -d -p 80:80 --name image_searcher saitamatechno/google_images_download:v1.0
16
20
```
17
21
18
22
## 📋 Requirements
19
23
20
-
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:
24
+
To use this software effectively, please ensure you have [Python](https://www.python.org/) 3.8 or later installed. You also need to install the necessary dependencies listed in the `requirements.txt` file, which includes libraries like [Selenium](https://www.selenium.dev/documentation/). Install them using pip:
21
25
22
26
```bash
23
-
$ pip install -r requirements.txt
27
+
pip install -r requirements.txt
24
28
```
25
29
26
-
The `requirements.txt` file is located [here](https://github.com/ultralytics/google-images-download/blob/main/requirements.txt), which includes `selenium` among others.
30
+
You can find the `requirements.txt` file [here](https://github.com/ultralytics/google-images-download/blob/main/requirements.txt).
27
31
28
32
## ⚙️ Installation
29
33
30
-
To set up the image scraper on your machine, clone this repository and install the dependencies as shown below:
34
+
To set up the Bing image scraper on your local machine, clone this repository and install the required dependencies:
1. Ensure Google Chrome is installed on your machine. If not, download and install from [here](https://www.google.com/chrome/).
44
+
Follow these steps to run the image scraper:
43
45
44
-
2. Download and update chromedriver corresponding to your version of Chrome [here](https://developer.chrome.com/docs/chromedriver/).
46
+
1.**Install Google Chrome**: Ensure Google Chrome is installed on your system. If not, download it from the official [Google Chrome website](https://www.google.com/chrome/).
47
+
2.**Download ChromeDriver**: Get the correct version of ChromeDriver that matches your installed Chrome version. Download links and instructions are available on the [ChromeDriver documentation page](https://developer.chrome.com/docs/chromedriver/). Make sure to note the path to the downloaded `chromedriver` executable.
48
+
3.**Execute the Script**: Run the `bing_scraper.py` script using Python. You can specify a Bing Images search results URL using the `--url` argument or provide search terms directly with the `--search` argument. Images will be saved to the `./images` directory by default. The script is designed to skip images that cause errors during download. For insights into data collection best practices, check out our blog post on [exploring data labeling](https://www.ultralytics.com/blog/exploring-data-labeling-for-computer-vision-projects).
45
49
46
-
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.
The downloaded images can be useful for creating custom [computer vision datasets](https://docs.ultralytics.com/datasets/).
65
+
66
+
<imgsrc="https://user-images.githubusercontent.com/26833433/75287228-dcf2ca80-57ce-11ea-9557-cc13abaff453.jpg"width="800"alt="Example output showing downloaded images in a folder">
63
67
64
68
## 📜 Citing the Project
65
69
66
-
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).
70
+
If you use this software in your research or projects, please acknowledge the original work by citing the [hardikvasa/google-images-download](https://github.com/hardikvasa/google-images-download) repository.
67
71
68
72
## 🤝 Contributing
69
73
70
-
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!
74
+
Contributions from the community are highly encouraged and appreciated! Your input helps make this open-source tool better for everyone. Whether it's reporting a bug, suggesting a new feature, or submitting code improvements, please refer to our [Contributing Guide](https://docs.ultralytics.com/help/contributing/) for details on how to get started.
71
75
72
-
<!-- Image to showcase our contributors -->
76
+
We also invite you to participate in our [Survey](https://www.ultralytics.com/survey?utm_source=github&utm_medium=social&utm_campaign=Survey) to share your feedback, helping us understand your needs and improve our offerings. A heartfelt thank you 🙏 to all our contributors for their dedication and support!
We offer two types of licensing to cater for a variety of use cases:
82
+
Ultralytics provides two licensing options to accommodate different usage needs:
80
83
81
-
### AGPL-3.0 License
82
-
83
-
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.
84
-
85
-
### Enterprise License
86
-
87
-
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).
84
+
-**AGPL-3.0 License**: Ideal for students, researchers, and enthusiasts working on open-source projects. It promotes collaboration and knowledge sharing. See the [LICENSE](https://github.com/ultralytics/ultralytics/blob/main/LICENSE) file for full details.
85
+
-**Enterprise License**: Designed for commercial use cases, this license allows integration of Ultralytics software into proprietary products and services without the open-source requirements of AGPL-3.0. For more information, visit [Ultralytics Licensing](https://www.ultralytics.com/license).
88
86
89
87
## 📬 Contact
90
88
91
-
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.
89
+
For bug reports, feature requests, or any issues related to this repository, please use the[GitHub Issues](https://github.com/ultralytics/google-images-download/issues)tracker. For broader questions, discussions, and community interaction, join our [Discord](https://discord.com/invite/ultralytics)server.
0 commit comments