Google Image Downloader Pro

A powerful GUI tool that allows users to search and download multiple high-quality images from Google Images with just a few clicks.

---

Key Features

• ✅ Intuitive, modern graphical interface (Dark Mode).
• ✅ Allows pasting keywords directly or loading from a .txt file.
• ✅ Choose the number of images per keyword (up to 20 images).
• ✅ Supports .jpeg, .jpg, .png image formats.
• ✅ Automatically saves images to your chosen directory.
• ✅ Displays download progress, detailed logs, and success/failure statistics.
• ✅ Non-blocking UI during downloads (utilizes multi-threading).

---

System Requirements

• Python 3.7+

• The following libraries:

  pip install pillow requests python-dotenv

---

How to Use

1. Run the program:

python image_downloader.py

2. In the interface:

• Enter keywords in the left panel (or click 📁 Load .txt file).
• Select the number of images to download per keyword and the save directory.
• Click the ** Start Download** button.

---

Example Keyword File (keywords.txt):

cat
mountain landscape
anime drawing

---

⚙️ Google API Configuration (Required)

To use the program, you need:

• Google Custom Search API Key
• Search Engine ID (CX)

You can obtain them for free from:

• https://programmablesearchengine.google.com/
• https://console.cloud.google.com/apis

Important: Fill in your API_KEY and CX in a .env file in the same directory as image_downloader.py before use. The application loads these credentials from the .env file.

Example .env file content:

API_KEY=YOUR_API_KEY_HERE
CX=YOUR_CX_HERE

---

🛠 Packaging to an .exe file (Windows)

If you want to create a single executable file:

pip install pyinstaller
pyinstaller --onefile --noconsole image_downloader.py

The .exe file will be located in the dist/ directory.

---

Sample Interface

---

📄 License

MIT License – Free to use for personal or commercial purposes.

---