Skip to content

README.md

Latest commit

 

History

History
141 lines (104 loc) · 3.25 KB

README.md

File metadata and controls

141 lines (104 loc) · 3.25 KB

Google Image Downloader

A Python-based application to download images from Google Images with a clean web interface.

📝 Features

  • Simple and intuitive web interface
  • Batch download of images from Google
  • Custom search query support
  • Specify number of images to download
  • Download progress tracking
  • Image preview functionality
  • Customizable download directory

🛠️ Technology Stack

  • Frontend: HTML, CSS, JavaScript
  • Backend: Python with Flask/Django
  • Image Download: google_images_download
  • Styling: Bootstrap 5/Tailwind

⚙️ Installation

  1. Clone the repository
git clone https://github.com/LUG-Ti/Google-Image.git
cd google-image-downloader
  1. Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. Install required packages
pip install -r requirements.txt

📦 Dependencies

flask==2.0.1
google_images_download==2.8.0
requests==2.26.0
pillow==8.3.1

🚀 Usage

  1. Start the Flask server:
python app.py

  1. Open your browser and navigate to http://localhost:5000

  2. Enter your search query and desired number of images

  3. Click "Download" and wait for the process to complete

📁 Project Structure

google-image-downloader/
│
└── [GitHub Username]/
     ├── app.py                 # Flask application
     ├── requirements.txt       # Project dependencies
     ├── README.md             # Project documentation
     │
     ├── static/
     │   ├── css/             # Stylesheets
     │   ├── js/              # JavaScript files
     │   └── downloads/       # Downloaded images
     │
     └── templates/
         └── index.html       # Main interface

💻 Development

Setting Up Development Environment

  1. Fork the repository

  2. Create a new branch

git checkout -b feature/your-feature-name
  1. Make your changes and commit
git add .
git commit -m "Add your commit message"
  1. Push to your fork
git push origin feature/your-feature-name
  1. Create a Pull Request

Code Style

  • Follow PEP 8 guidelines for Python code
  • Use meaningful variable and function names
  • Add comments for complex logic
  • Write docstrings for functions and classes

🤝 Contributing

  1. Fork the project
  2. Create your feature branch
  3. Commit your changes
  4. Push to the branch
  5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Resources

⚠️ Disclaimer

This tool is for educational purposes only. Please review Google's terms of service and ensure compliance with their policies when downloading images.

📧 Contact