# 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.
### 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'.
### 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 <br />
#### Variant 1: From PyPI
First, uninstall the original bing_image_donwloader if installed:
```bash
pip uninstall bing_image_downloader -y
````
Then install the forked version:
```bash
pip install bing-image-downloader-ext
```
#### Variant 2: From GitHub
```bash
pip install git+https://github.com/loglux/bing_image_downloader.git
```
or
```bash
git clone https://github.com/loglux/bing_image_downloader
cd bing_image_downloader
pip install .
```
### Usage <br />
```python
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')
```
### Parameters
`query_string` : String to be searched.<br />
`limit` : (optional, default is 100) Number of images to download.<br />
`output_dir` : (optional, default is 'dataset') Name of output dir.<br />
`adult_filter_off` : (optional, default is True) Enable of disable adult filteration.<br />
`force_replace` : (optional, default is False) Delete folder if present and start a fresh download.<br />
`timeout` : (optional, default is 60) timeout for connection in seconds.<br />
`filter` : (optional, default is "") filter, choose from [line, photo, clipart, gif, transparent]<br />
`verbose` : (optional, default is True) Enable downloaded message.<br />
- `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'.
## Original Bing Image Downloader
https://github.com/gurugaurav/bing_image_downloader
Raw data
{
"_id": null,
"home_page": "https://github.com/loglux/bing_image_downloader",
"name": "bing-image-downloader-ext",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "bing, images, scraping, image download, bulk image downloader, resize, file type, size filter",
"author": "Loglux",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/42/f7/ccdf135e073a8454af41e969446ef06a9706ae02c522004db7c7fb6e89da/bing_image_downloader_ext-1.1.5.tar.gz",
"platform": null,
"description": "# Forked Bing Image Downloader\n## Overview\nThis 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.\n\n### New Features\n- `size`: (optional, default is \"\") Size of image, choose from [small, medium, large, wallpaper].\n- `resize_dim`: (optional, default is `None`) Resize the image to given dimensions, e.g., (256, 256).\n- `file_types`: (optional, default is `None` which means all types) Choose from 'jpg', 'png', 'gif', 'bmp'.\n\n### Disclaimer\nThis program lets you download tons of images from Bing.\nPlease do not download or use any image that violates its copyright terms. \n\n### Installation <br />\n\n#### Variant 1: From PyPI\n\nFirst, uninstall the original bing_image_donwloader if installed:\n```bash\npip uninstall bing_image_downloader -y\n````\nThen install the forked version:\n```bash\npip install bing-image-downloader-ext\n```\n#### Variant 2: From GitHub\n```bash\npip install git+https://github.com/loglux/bing_image_downloader.git\n```\nor \n```bash\ngit clone https://github.com/loglux/bing_image_downloader\ncd bing_image_downloader\npip install .\n```\n### Usage <br />\n```python\nfrom bing_image_downloader import downloader\n\nsearch_queries = [\"grizzly bear\", \"black bear\", \"teddy bear\"]\n\nfor query in search_queries:\n downloader.download(query, \n limit=100, \n output_dir='dataset', \n adult_filter_off=True, \n force_replace=False, \n timeout=5, \n verbose=True,\n size=\"medium\",\n resize_dim=(224, 224),\n file_type='jpg,png')\n```\n### Parameters\n`query_string` : String to be searched.<br />\n`limit` : (optional, default is 100) Number of images to download.<br />\n`output_dir` : (optional, default is 'dataset') Name of output dir.<br />\n`adult_filter_off` : (optional, default is True) Enable of disable adult filteration.<br />\n`force_replace` : (optional, default is False) Delete folder if present and start a fresh download.<br />\n`timeout` : (optional, default is 60) timeout for connection in seconds.<br />\n`filter` : (optional, default is \"\") filter, choose from [line, photo, clipart, gif, transparent]<br />\n`verbose` : (optional, default is True) Enable downloaded message.<br />\n- `size`: (optional, default is \"\") Size of image, choose from [small, medium, large, wallpaper].\n- `resize_dim`: (optional, default is `None`) Resize the image to given dimensions, e.g., (256, 256).\n- `file_types`: (optional, default is `None` which means all types) Choose from 'jpg', 'png', 'gif', 'bmp'.\n\n## Original Bing Image Downloader\nhttps://github.com/gurugaurav/bing_image_downloader\n\n\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Forked version of bing_image_downloader with support for resizing, file types, and size filters",
"version": "1.1.5",
"project_urls": {
"Homepage": "https://github.com/loglux/bing_image_downloader"
},
"split_keywords": [
"bing",
" images",
" scraping",
" image download",
" bulk image downloader",
" resize",
" file type",
" size filter"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3b9b6a2879cc82f1bccb7c1cdd2bd305fcfea2cf9d522401e37262cfd7a2bdfa",
"md5": "d57ccdbea478aa69bd3bd6a337f03786",
"sha256": "5873ab629e7c6a0c7045cd8474b617677b2467acf02e872cbc5b50a66c46a9d6"
},
"downloads": -1,
"filename": "bing_image_downloader_ext-1.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d57ccdbea478aa69bd3bd6a337f03786",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 6210,
"upload_time": "2024-07-04T10:06:33",
"upload_time_iso_8601": "2024-07-04T10:06:33.030774Z",
"url": "https://files.pythonhosted.org/packages/3b/9b/6a2879cc82f1bccb7c1cdd2bd305fcfea2cf9d522401e37262cfd7a2bdfa/bing_image_downloader_ext-1.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "42f7ccdf135e073a8454af41e969446ef06a9706ae02c522004db7c7fb6e89da",
"md5": "4d4330f511c3aa31515bfea9c8a93579",
"sha256": "5538c07d8147020e2b1b457bfa264dba3d070ec7c91b16bad432e5ed6c2de425"
},
"downloads": -1,
"filename": "bing_image_downloader_ext-1.1.5.tar.gz",
"has_sig": false,
"md5_digest": "4d4330f511c3aa31515bfea9c8a93579",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5315,
"upload_time": "2024-07-04T10:06:34",
"upload_time_iso_8601": "2024-07-04T10:06:34.354514Z",
"url": "https://files.pythonhosted.org/packages/42/f7/ccdf135e073a8454af41e969446ef06a9706ae02c522004db7c7fb6e89da/bing_image_downloader_ext-1.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-04 10:06:34",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "loglux",
"github_project": "bing_image_downloader",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "bing-image-downloader-ext"
}
JSON
