Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kts-o7/better_bing_image_downloader
Python library to download bulk of images from Bing
https://github.com/kts-o7/better_bing_image_downloader
bing-image-downloader bing-image-scrapping image-dataset-maker image-datasets image-downloader-python image-scraper image-scrapping mage-downloader python-image-download python-image-downloader python-image-webcrawler python-imagesearch web-image-downloader
Last synced: 5 days ago
JSON representation
Python library to download bulk of images from Bing
- Host: GitHub
- URL: https://github.com/kts-o7/better_bing_image_downloader
- Owner: KTS-o7
- License: mit
- Created: 2024-02-15T10:05:39.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-04-20T20:12:28.000Z (7 months ago)
- Last Synced: 2024-10-31T17:09:51.356Z (15 days ago)
- Topics: bing-image-downloader, bing-image-scrapping, image-dataset-maker, image-datasets, image-downloader-python, image-scraper, image-scrapping, mage-downloader, python-image-download, python-image-downloader, python-image-webcrawler, python-imagesearch, web-image-downloader
- Language: Python
- Homepage: https://pypi.org/project/better-bing-image-downloader/
- Size: 54.7 KB
- Stars: 24
- Watchers: 1
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Better Bing Image Downloader
## Table of Contents
- [Disclaimer](#disclaimer)
- [Installation](#installation)
- [Usage](#usage)
- [License](#license)
- [Contact](#contact)
### Disclaimer
This program lets you download tons of images from Bing.
Please do not download or use any image that violates its copyright terms.
[](https://hits.seeyoufarm.com)
### Installation
```bash
git clone https://github.com/KTS-o7better_bing_image_downloader
python -m venv ./env
source env/bin/activate
cd better_bing_image_downloader
pip install .
```
or
```bash
pip install better-bing-image-downloader
```
### PyPi
[Package Link](https://pypi.org/project/better-bing-image-downloader/)
### Usage
#### Using as a Package:
```python
from better_bing_image_downloader import downloader
downloader(query_string, limit=100, output_dir='dataset', adult_filter_off=True,
force_replace=False, timeout=60, filter="", verbose=True, badsites= [], name='Image')
```
`query_string` : String to be searched.
`limit` : (optional, default is 100) Number of images to download.
`output_dir` : (optional, default is 'dataset') Name of output dir.
`adult_filter_off` : (optional, default is True) Enable of disable adult filteration.
`force_replace` : (optional, default is False) Delete folder if present and start a fresh download.
`timeout` : (optional, default is 60) timeout for connection in seconds.
`filter` : (optional, default is "") filter, choose from [line, photo, clipart, gif, transparent]
`verbose` : (optional, default is True) Enable downloaded message.
`bad-sites` : (optional, defualt is empty list) Can limit the query to not access the bad sites.
`name` : (optional, default is 'Image') Can add a custom name for the images that are downloaded.
#### Using as a Command Line Tool:
```bash
git clone https://github.com/KTS-o7/better_bing_image_downloader.git
cd better_bing_image_downloader
python -m venv ./env
source env/bin/activate
pip install -r requirements.txt
cd better_bing_image_downloader
# This is an example query
python multidownloader.py "cool doggos" --engine "Bing" --max-number 50 --num-threads 5 --driver "firefox_headless"
```
#### Command Line Arguments:
```bash
multidownloader.py "keywords" [-h] [--engine {Google,Bing}] [--driver {chrome_headless,chrome,api,firefox,firefox_headless}] [--max-number MAX_NUMBER] [--num-threads NUM_THREADS] [--timeout TIMEOUT] [--output OUTPUT] [--safe-mode] [--face-only] [--proxy_http PROXY_HTTP] [--proxy_socks5 PROXY_SOCKS5] [--type {clipart,linedrawing,photograph}] [--color COLOR]
```
- `"keywords"`: Keywords to search. ("in quotes")
- `-h, --help`: Show the help message and exit
- `--engine, -e`: Image search engine. Choices are "Google" and "Bing". Default is "Bing".
- `--driver, -d`: Image search engine. Choices are "chrome_headless", "chrome", "api", "firefox", "firefox_headless". Default is "firefox_headless".
- `--max-number, -n`: Max number of images download for the keywords. Default is 100.
- `--num-threads, -j`: Number of threads to concurrently download images. Default is 50.
- `--timeout, -t`: Seconds to timeout when download an image. Default is 10.
- `--output, -o`: Output directory to save downloaded images. Default is "./download_images".
- `--safe-mode, -S`: Turn on safe search mode. (Only effective in Google)
- `--face-only, -`F: Only search for faces.
- `--proxy_http, -ph`: Set http proxy (e.g. 192.168.0.2:8080)
- `--proxy_socks5, -ps`: Set socks5 proxy (e.g. 192.168.0.2:1080)
- -`-type, -ty`: What kinds of images to download. Choices are "clipart", "linedrawing", "photograph".
- `--color, -cl`: Specify the color of desired images.
```bash
# Example usage
python multidownloader.py "Cool Doggos" --engine "Google" --driver "chrome_headless" --max-number 50 --num-threads 10 --timeout 60 --output "./doggo_images" --safe-mode --proxy_http "192.168.0.2:8080" --type "photograph" --color "blue"
```
---
## Star History
[](https://star-history.com/#KTS-o7/better-bing-image-downloader&Date)
### License
This project is licensed under the terms of the MIT license.
### Contact
If you have any questions or feedback, please contact us at [email](mailto:[email protected]).