# Better Bing Image Downloader
## Table of Contents
- [Disclaimer](#disclaimer)
- [Installation](#installation)
- [Usage](#usage)
- [License](#license)
- [Contact](#contact)
### Disclaimer<br />
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 <br />
```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 <br />
[Package Link](https://pypi.org/project/better-bing-image-downloader/)
### Usage <br />
#### 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.<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 />
`bad-sites` : (optional, defualt is empty list) Can limit the query to not access the bad sites.<br/>
`name` : (optional, default is 'Image') Can add a custom name for the images that are downloaded.<br/>
#### 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 --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:shentharkrishnatejaswi@gmail.com).
Raw data
{
"_id": null,
"home_page": "https://github.com/KTS-o7/better_bing_image_downloader",
"name": "better-bing-image-downloader",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "bing, images, scraping, image download, bulk image downloader",
"author": "Krishnatejaswi S",
"author_email": "shentharkrishnatejaswi@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/62/98/0da044111ad44b5e52ed688db77d4ed2d7aaa772847edd252dc49bf75821/better_bing_image_downloader-1.1.2.tar.gz",
"platform": null,
"description": "# Better Bing Image Downloader\n\n## Table of Contents\n\n- [Disclaimer](#disclaimer)\n- [Installation](#installation)\n- [Usage](#usage)\n- [License](#license)\n- [Contact](#contact)\n\n### Disclaimer<br />\n\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\n\n[](https://hits.seeyoufarm.com)\n\n### Installation <br />\n\n```bash\ngit clone https://github.com/KTS-o7better_bing_image_downloader\npython -m venv ./env\nsource env/bin/activate\ncd better_bing_image_downloader\npip install .\n```\n\nor\n\n```bash\npip install better-bing-image-downloader\n```\n\n### PyPi <br />\n\n[Package Link](https://pypi.org/project/better-bing-image-downloader/)\n\n### Usage <br />\n#### Using as a Package:\n```python\nfrom better_bing_image_downloader import downloader\n\ndownloader(query_string, limit=100, output_dir='dataset', adult_filter_off=True,\nforce_replace=False, timeout=60, filter=\"\", verbose=True, badsites= [], name='Image')\n```\n\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`bad-sites` : (optional, defualt is empty list) Can limit the query to not access the bad sites.<br/>\n`name` : (optional, default is 'Image') Can add a custom name for the images that are downloaded.<br/>\n\n#### Using as a Command Line Tool:\n```bash\n git clone https://github.com/KTS-o7/better_bing_image_downloader.git\n cd better_bing_image_downloader\n python -m venv ./env\n source env/bin/activate\n pip install -r requirements.txt\n cd better_bing_image_downloader\n # This is an example query\n python multidownloader.py \"cool doggos\" --engine \"Bing\" --max-number 50 --num-threads 5 --driver \"firefox_headless\" \n```\n#### Command Line Arguments:\n```bash\nmultidownloader.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]\n```\n- `\"keywords\"`: Keywords to search. (\"in quotes\")\n- `-h, --help`: Show the help message and exit\n- `--engine, -e`: Image search engine. Choices are \"Google\" and \"Bing\". Default is \"Bing\".\n- `--driver, -d`: Image search engine. Choices are \"chrome_headless\", \"chrome\", \"api\", \"firefox\", \"firefox_headless\". Default is \"firefox_headless\".\n- `--max-number, -n`: Max number of images download for the keywords. Default is 100.\n- `--num-threads, -j`: Number of threads to concurrently download images. Default is 50.\n- `--timeout, -t`: Seconds to timeout when download an image. Default is 10.\n- `--output, -o`: Output directory to save downloaded images. Default is \"./download_images\".\n- `--safe-mode, -S`: Turn on safe search mode. (Only effective in Google)\n- `--face-only, -`F: Only search for faces.\n- `--proxy_http, -ph`: Set http proxy (e.g. 192.168.0.2:8080)\n- `--proxy_socks5, -ps`: Set socks5 proxy (e.g. 192.168.0.2:1080)\n- -`-type, -ty`: What kinds of images to download. Choices are \"clipart\", \"linedrawing\", \"photograph\".\n- `--color, -cl`: Specify the color of desired images.\n\n```bash\n# Example usage\npython multidownloader.py \"Cool Doggos\" --engine Google --driver chrome --max-number 50 --num-threads 10 --timeout 60 --output \"./doggo_images\" --safe-mode --proxy_http \"192.168.0.2:8080\" --type photograph --color blue\n```\n---\n## Star History\n\n[](https://star-history.com/#KTS-o7/better-bing-image-downloader&Date)\n\n### License\n\nThis project is licensed under the terms of the MIT license.\n\n### Contact\n\nIf you have any questions or feedback, please contact us at [email](mailto:shentharkrishnatejaswi@gmail.com).\n",
"bugtrack_url": null,
"license": null,
"summary": "This package is built on top of bing-image-downloader by gaurav singh",
"version": "1.1.2",
"project_urls": {
"Homepage": "https://github.com/KTS-o7/better_bing_image_downloader"
},
"split_keywords": [
"bing",
" images",
" scraping",
" image download",
" bulk image downloader"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5a58e99fecc593e2d22252b8bb5ac113ab3917a5aa2d1f2f9ef7edfffb5444e6",
"md5": "59aee0ab9dc7ce6a8e528907cb9dc252",
"sha256": "099254fa9ff8af2d2b3e8c68bb54bcb296a2122c3cbd35f15223a4ab5738e03e"
},
"downloads": -1,
"filename": "better_bing_image_downloader-1.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "59aee0ab9dc7ce6a8e528907cb9dc252",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 15706,
"upload_time": "2024-04-20T19:06:15",
"upload_time_iso_8601": "2024-04-20T19:06:15.920445Z",
"url": "https://files.pythonhosted.org/packages/5a/58/e99fecc593e2d22252b8bb5ac113ab3917a5aa2d1f2f9ef7edfffb5444e6/better_bing_image_downloader-1.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "62980da044111ad44b5e52ed688db77d4ed2d7aaa772847edd252dc49bf75821",
"md5": "001670226814fb5d0c65762a5d40e1f0",
"sha256": "c6ed5a97fc8e3ab2fc9239bf26a313b665fca5dc9e8e07880844122171a44050"
},
"downloads": -1,
"filename": "better_bing_image_downloader-1.1.2.tar.gz",
"has_sig": false,
"md5_digest": "001670226814fb5d0c65762a5d40e1f0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 14773,
"upload_time": "2024-04-20T19:06:17",
"upload_time_iso_8601": "2024-04-20T19:06:17.631099Z",
"url": "https://files.pythonhosted.org/packages/62/98/0da044111ad44b5e52ed688db77d4ed2d7aaa772847edd252dc49bf75821/better_bing_image_downloader-1.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-20 19:06:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "KTS-o7",
"github_project": "better_bing_image_downloader",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "better-bing-image-downloader"
}
JSON
