{"id":19360258,"url":"https://github.com/kts-o7/better_bing_image_downloader","last_synced_at":"2025-09-10T10:34:44.635Z","repository":{"id":222640897,"uuid":"757944444","full_name":"KTS-o7/better_bing_image_downloader","owner":"KTS-o7","description":"Python library to download bulk of images from Bing","archived":false,"fork":false,"pushed_at":"2025-03-20T11:47:58.000Z","size":41,"stargazers_count":31,"open_issues_count":1,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-13T00:08:37.446Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/better-bing-image-downloader/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KTS-o7.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-15T10:05:39.000Z","updated_at":"2025-04-01T08:40:46.000Z","dependencies_parsed_at":"2024-04-20T17:37:52.481Z","dependency_job_id":"fa4eb29c-0f1b-44de-9c74-13af470d5059","html_url":"https://github.com/KTS-o7/better_bing_image_downloader","commit_stats":null,"previous_names":["kts-o7/better-bing-image-downloader","kts-o7/better_bing_image_downloader"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KTS-o7%2Fbetter_bing_image_downloader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KTS-o7%2Fbetter_bing_image_downloader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KTS-o7%2Fbetter_bing_image_downloader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KTS-o7%2Fbetter_bing_image_downloader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KTS-o7","download_url":"https://codeload.github.com/KTS-o7/better_bing_image_downloader/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248647299,"owners_count":21139086,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2024-11-10T07:17:33.845Z","updated_at":"2025-09-10T10:34:44.623Z","avatar_url":"https://github.com/KTS-o7.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Better Bing Image Downloader\n\nA powerful Python tool for downloading images from Bing and Google image search engines.\n\n[![GitHub top language](https://img.shields.io/github/languages/top/KTS-o7/better_bing_image_downloader)](https://github.com/KTS-o7/better_bing_image_downloader)\n[![GitHub](https://img.shields.io/github/license/KTS-o7/better-bing-image-downloader)](https://github.com/KTS-o7/better-bing-image-downloader/blob/main/LICENSE)\n[![PyPI version](https://badge.fury.io/py/better-bing-image-downloader.svg)](https://pypi.org/project/better-bing-image-downloader/)\n[![Hits](https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2FKTS-o7%2Fbetter_bing_image_downloader\u0026count_bg=%2379C83D\u0026title_bg=%23555555\u0026icon=\u0026icon_color=%23E7E7E7\u0026title=hits\u0026edge_flat=false)](https://hits.seeyoufarm.com)\n\n## Features\n\n- Download images from Bing and Google search engines\n- Parallel downloading for significantly faster performance\n- Multiple filtering options (image type, color, adult content, etc.)\n- Support for both API and browser-based image retrieval\n- Command-line interface and Python API\n- Multiple browser support (Firefox, Chrome, headless options)\n- Proxy support\n\n## Table of Contents\n\n- [Installation](#installation)\n- [Usage](#usage)\n  - [Python API](#python-api)\n  - [Command Line Interface](#command-line-interface)\n- [Parameters](#parameters)\n- [Examples](#examples)\n- [License](#license)\n- [Disclaimer](#disclaimer)\n- [Changelog](#changelog)\n- [Contact](#contact)\n\n## Installation\n\n### Using pip\n\n```bash\npip install better-bing-image-downloader\n```\n\n### From source\n\n```bash\ngit clone https://github.com/KTS-o7/better_bing_image_downloader\ncd better_bing_image_downloader\npython -m venv ./env\nsource env/bin/activate  # On Windows: env\\Scripts\\activate\npip install -r requirements.txt\npip install .\n```\n\n## Usage\n\n### Python API\n\n```python\nfrom better_bing_image_downloader import downloader\n\n# Basic usage\ndownloader(\"cute puppies\", limit=50)\n\n# Advanced usage\ndownloader(\n    query=\"cute puppies\",\n    limit=100,\n    output_dir=\"my_images\",\n    adult_filter_off=True,\n    force_replace=False,\n    timeout=60,\n    filter=\"photo\",  # Options: \"line\", \"photo\", \"clipart\", \"gif\", \"transparent\"\n    verbose=True,\n    badsites=[\"stock.adobe.com\", \"shutterstock.com\"],\n    name=\"Puppy\",\n    max_workers=8  # Parallel downloads\n)\n```\n\n### Command Line Interface\n\nThe package provides two command-line interfaces:\n\n#### 1. Simple CLI (Bing-only)\n\n```bash\npython -m better_bing_image_downloader.download \"query\" [options]\n```\n\n#### 2. Advanced CLI (Bing and Google)\n\n```bash\npython -m better_bing_image_downloader.multidownloader \"query\" [options]\n```\n\n## Parameters\n\n### Python API Parameters\n\n| Parameter        | Type | Default    | Description                                                |\n| ---------------- | ---- | ---------- | ---------------------------------------------------------- |\n| query            | str  | (required) | Search term                                                |\n| limit            | int  | 100        | Maximum number of images to download                       |\n| output_dir       | str  | 'dataset'  | Directory to save images                                   |\n| adult_filter_off | bool | True       | Disable adult content filter                               |\n| force_replace    | bool | False      | Replace existing files and directories                     |\n| timeout          | int  | 60         | Connection timeout in seconds                              |\n| filter           | str  | \"\"         | Image type filter (line, photo, clipart, gif, transparent) |\n| verbose          | bool | True       | Display detailed output                                    |\n| badsites         | list | []         | List of sites to exclude from results                      |\n| name             | str  | 'Image'    | Base name for downloaded images                            |\n| max_workers      | int  | 4          | Number of parallel download threads                        |\n\n### Command Line Arguments (multidownloader.py)\n\n| Argument       | Short | Default             | Description                                          |\n| -------------- | ----- | ------------------- | ---------------------------------------------------- |\n| --engine       | -e    | \"Bing\"              | Search engine (\"Google\" or \"Bing\")                   |\n| --driver       | -d    | \"firefox_headless\"  | Browser driver to use                                |\n| --max-number   | -n    | 100                 | Maximum number of images to download                 |\n| --num-threads  | -j    | 50                  | Number of concurrent download threads                |\n| --timeout      | -t    | 10                  | Download timeout in seconds                          |\n| --output       | -o    | \"./download_images\" | Output directory                                     |\n| --safe-mode    | -S    | False               | Enable safe search mode                              |\n| --face-only    | -F    | False               | Only search for faces                                |\n| --proxy_http   | -ph   | None                | HTTP proxy address (e.g., 192.168.0.2:8080)          |\n| --proxy_socks5 | -ps   | None                | SOCKS5 proxy address (e.g., 192.168.0.2:1080)        |\n| --type         | -ty   | None                | Image type filter (clipart, linedrawing, photograph) |\n| --color        | -cl   | None                | Color filter for images                              |\n\n## Examples\n\n### Basic Search\n\n```python\nfrom better_bing_image_downloader import downloader\n\n# Download 100 cat images to ./dataset/cats\ndownloader(\"cats\", limit=100)\n```\n\n### Advanced Search with Filters\n\n```python\n# Download 50 transparent clipart images with parallel processing\ndownloader(\n    query=\"logo design\",\n    limit=50,\n    filter=\"transparent\",\n    max_workers=8,\n    output_dir=\"logos\"\n)\n```\n\n### Command Line Usage\n\n```bash\n# Download 50 landscape photographs using Google\npython -m better_bing_image_downloader.multidownloader \"mountain landscape\" --engine \"Google\" --max-number 50 --type \"photograph\"\n\n# Download 100 cat images using Bing with Firefox headless\npython -m better_bing_image_downloader.multidownloader \"cats\" --engine \"Bing\" --driver \"firefox_headless\" --max-number 100\n```\n\n## Disclaimer\n\nThis program lets you download images from search engines. Please do not download or use any image that violates its copyright terms. The developers of this tool are not responsible for any misuse.\n\n## Changelog\n\n### 2.0.0\n\n- Added parallel downloading for significantly faster image retrieval\n- Improved error handling and recovery\n- Better memory management and code organization\n- Fixed progress bar display issues\n- Added max_workers parameter to control parallel downloads\n- Added new requirements\n\n### 1.1.3\n\n- Fixed issue with invalid image types\n- Replaced imghdr with filetype for more reliable image type detection\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Contact\n\nIf you have any questions or feedback, please contact the developer at [shentharkrishnatejaswi@gmail.com](mailto:shentharkrishnatejaswi@gmail.com).\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=KTS-o7/better-bing-image-downloader\u0026type=Date)](https://www.star-history.com/#KTS-o7/better-bing-image-downloader\u0026Date)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkts-o7%2Fbetter_bing_image_downloader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkts-o7%2Fbetter_bing_image_downloader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkts-o7%2Fbetter_bing_image_downloader/lists"}