A modern GUI application built with Python and CustomTkinter for downloading high-quality images from Pexels API in bulk.
- 🖼️ Bulk Image Downloads: Download multiple images across different categories
- 🎨 Quality Selection: Choose from Original, Large, or Medium quality
- 📁 Organized Storage: Automatically creates timestamped folders for each category
- 🚫 Duplicate Prevention: Prevents downloading the same image multiple times
- 📊 Progress Tracking: Real-time progress updates and status messages
- 🛑 Cancellable Downloads: Stop downloads at any time
- 🌙 Dark Theme: Modern dark UI using CustomTkinter
- Python 3.7 or higher
- Pexels API Key (free from Pexels Developers)
- Clone this repository:
git clone https://github.com/MatsoDev/Pexel-Downloader.git
cd Pexel-Downloader- Install required dependencies:
pip install -r requirements.txt-
Get your Pexels API key:
- Visit Pexels API
- Create a free account
- Generate an API key
-
Update the API key in the code:
- Open
main.py - Replace
API_KEYwith your actual Pexels API key
- Open
- Run the application:
python main.py- Enter your desired categories (comma-separated)
- Set the number of images per category
- Choose image quality
- Click "Start Download"
- Maximum images per category: 1000
- Maximum categories: 10
- Supported formats: JPG, JPEG, PNG, WebP
- Rate limiting: Built-in handling for API rate limits
pexels-image-downloader/
├── main.py # Main application file
├── requirements.txt # Python dependencies
├── README.md # Project documentation
├── .gitignore # Git ignore rules
└── download_log.txt # Download history (created automatically)
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
This tool is for educational and personal use only. Please respect Pexels' terms of service and the photographers' rights. Always check the license of each image before commercial use.
- Pexels for providing the amazing API and free stock photos
- CustomTkinter for the modern GUI framework
