Forked Bing Image Downloader

Overview

This is a forked version of Bing Image Downloader with additional features. This Python library allows you to download a bulk of images from Bing.com. The inspiration for this fork came from the book Deep Learning for Coders with Fastai and PyTorch, aiming to create a free tool for preparing datasets.

New Features

size: (optional, default is "") Size of image, choose from [small, medium, large, wallpaper].
resize_dim: (optional, default is None) Resize the image to given dimensions, e.g., (256, 256).
file_types: (optional, default is None which means all types) Choose from 'jpg', 'png', 'gif', 'bmp'.
label_filename: Using the image's label as its filename.

Disclaimer

This program lets you download tons of images from Bing. Please do not download or use any image that violates its copyright terms.

Installation

Variant 1: From PyPI

First, uninstall the original bing_image_donwloader if installed:

pip uninstall bing_image_downloader -y

Then install the forked version:

pip install bing-image-downloader-ext

Variant 2: From GitHub

pip install git+https://github.com/loglux/bing_image_downloader.git

git clone https://github.com/loglux/bing_image_downloader
cd bing_image_downloader
pip install .

Usage

from bing_image_downloader import downloader

search_queries = ["grizzly bear", "black bear", "teddy bear"]

for query in search_queries:
    downloader.download(query,
                        limit=100,
                        output_dir='dataset',
                        adult_filter_off=True,
                        force_replace=False,
                        timeout=5,
                        verbose=True,
                        size="medium",
                        resize_dim=(224, 224),
                        file_type='jpg,png',
                        label_filename=False)

Parameters

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.

size: (optional, default is "") Size of image, choose from [small, medium, large, wallpaper].
resize_dim: (optional, default is None) Resize the image to given dimensions, e.g., (256, 256).
file_type: (optional, default is None which means all types) Choose from 'jpg', 'png', 'gif', 'bmp'.
label_filename: (optional, default is False) Whether to use the image's label as its filename.

Original Bing Image Downloader

https://github.com/gurugaurav/bing_image_downloader