A package to download images from various search engines.
Project description
ImageEngine
ImageEngine is a Python package that allows users to search and download images from multiple sources such as DuckDuckGo, Bing, and Google. With a simple interface and command-line tools, you can easily obtain images related to any search term.
Features
- Search DuckDuckGo: Download images using the DuckDuckGo search engine.
- Search Bing: Download images using the Bing search engine.
- Search Google, DuckDuckGo, and Bing: Download images from all three search engines with a single command.
Installation
To install the package, simply run:
pip install ImageEngine
Alternatively, you can clone the repository and install it locally:
git clone https://github.com/jaypunekar/ImageEngine.git
cd ImageEngine
pip install .
Usage
Command Line Interface (CLI)
After installing the package, you can use the following commands from your terminal:
-
Search and download images from DuckDuckGo:
# "cute puppies" is the search string and "puppy_images" is the directory where images will be stored search-ddg term="cute puppies" path="puppy_images" --max_images=10
-
Search and download images from Bing:
search-bing term="beautiful landscapes" path="landscapes" --max_images=20
-
Search and download images from Google, DuckDuckGo, and Bing:
search-web term="happy animals" path="animals" --max_images=30
Using Functions in Python Scripts
You can also import the functions directly in your Python scripts:
from ImageEngine import searchDDG
from ImageEngine import searchBing
from ImageEngine import searchGoogle
from ImageEngine import searchWeb
# Search images from DuckDuckGo
# "sunset" is the search string and "sunset_images" is the directory where images will be stored
searchDDG(term="sunsets", path="sunset_images", max_images=10)
# Search images from Bing
searchBing(term="mountain views", path="mountain_images", max_images=15)
# Search images from Google
searchGoogle(term="river views", path="river_images", max_images=15)
# Search images from all three engines
searchWeb(term="cute cats", path="cat_images", max_images=20)
Requirements
- Python 3.6 or higher
duckduckgo_search
fastai
icrawler
- Other dependencies listed in
setup.py
Contributing
Contributions are welcome! Please fork the repository and submit a pull request to contribute.
License
This project is licensed under the MIT License. See the LICENSE
file for more details.
Contact
For any inquiries or issues, please contact jay.punekar@icloud.com.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ImageEngine-0.2.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 75b3e571b1d140b23aebc7767b1b7ad9d4b9e6044a66bd586c1d5bbb676c2005 |
|
MD5 | 53367b974711afe8f99d49214c4d2a50 |
|
BLAKE2b-256 | 579da7825e9bf55c825f6a964ad76866dba0fed534259f26e6264a9b86b8ec07 |