Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/srj101/image-downloader
My very first tiny software!
https://github.com/srj101/image-downloader
Last synced: 11 days ago
JSON representation
My very first tiny software!
- Host: GitHub
- URL: https://github.com/srj101/image-downloader
- Owner: srj101
- Created: 2024-12-15T11:27:00.000Z (21 days ago)
- Default Branch: master
- Last Pushed: 2024-12-15T11:33:09.000Z (21 days ago)
- Last Synced: 2024-12-15T12:26:16.482Z (21 days ago)
- Language: Python
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Image Processor GUI
## 🎨 Overview
The **Image Processor GUI** is a Python-based desktop application that simplifies working with images. It enables users to:
- **Search and download images** from Pixabay based on a keyword.
- **Process image files** (both JPG and PNG) with options to convert between formats.
- **Maintain directory structures** while ensuring no duplicate outputs.
- **Resize and store images** based on dimensions from input files.
This application includes a user-friendly GUI for seamless interaction and is packaged as an installable `.exe` file for easy distribution.
---
## ✨ Features
- **JPG and PNG Support**: Handles both `.jpg` and `.png` files, converting formats as necessary.
- **Pixabay Integration**: Downloads high-quality images from Pixabay using their API.
- **Unique Outputs**: Ensures no duplicate images in the output folder.
- **GUI-Based Interaction**: No need to modify code—operate through an intuitive graphical user interface.
- **Preserves Directory Structure**: Replicates the input folder structure for output files.
---
## 🔧 Installation
### Prerequisites
- Internet connection (for Pixabay API)
## 🖥️ Usage
1. **Launch the Application**:
- If using the `.exe` file: Double-click the executable.
2. **Choose Input and Output Directories**:
- Specify the folder containing input images.
- Select the output folder where processed files will be saved.
3. **Enter a Keyword**:
- Provide a keyword to search for relevant images on Pixabay.
4. **Start Processing**:
- Click the `Process Images` button to begin downloading, resizing, and saving images.
5. **View Results**:
- Processed images are saved in the output directory, maintaining the input folder's structure.
---
## 🚀 Purpose
### Why This Tool?
The **Image Processor GUI** was created to solve key challenges faced by professionals who deal with large volumes of images:
- **Time-Consuming Image Management**: Designers and developers often need to resize, convert, and organize images while preserving structure. This tool automates those tasks.
- **Finding High-Quality Visuals**: Integrating Pixabay ensures access to copyright-friendly, high-quality images, eliminating manual search efforts.
- **Avoiding Redundancy**: Duplicate images can clutter directories and waste storage. This application ensures unique outputs every time.
### Ideal Use Cases
- **Design Agencies**: Quickly resize and organize images for multiple projects.
- **Web Developers**: Automate image processing for website assets.
- **Content Creators**: Find and prepare visuals for blogs, videos, or presentations.
By combining automation with user-friendliness, the tool saves valuable time and effort while ensuring professional results.
---
## 🖼️ Screenshots
### Main Interface
## 📜 License
This project is licensed under the **MIT License**. Feel free to modify and distribute it as per the license terms.
---
## 🤝 Contributing
Contributions are welcome! To contribute:
1. Fork the repository.
2. Create a feature branch:
```bash
git checkout -b feature-name
```
3. Commit your changes and push the branch:
```bash
git push origin feature-name
```
4. Open a pull request.
---
## 📝 Acknowledgments
- **Pixabay** for providing a robust image API.
- **Pillow (PIL)** for image manipulation.
- The open-source community for their invaluable tools and libraries.
---
## 📧 Contact
For questions or feedback, please reach out to:
- **Email**: [email protected]
- **GitHub**: [srj101](https://github.com/srj101)
---
Happy Processing! 🎉