Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/marwan-ahmed-23/image-converter-python
A Python-based tool for converting images between PNG, JPEG, GIF, and BMP formats with clean, modular code.
https://github.com/marwan-ahmed-23/image-converter-python
Last synced: 10 days ago
JSON representation
A Python-based tool for converting images between PNG, JPEG, GIF, and BMP formats with clean, modular code.
- Host: GitHub
- URL: https://github.com/marwan-ahmed-23/image-converter-python
- Owner: marwan-ahmed-23
- Created: 2024-11-29T21:41:28.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-12-20T03:50:31.000Z (27 days ago)
- Last Synced: 2024-12-20T04:33:52.970Z (27 days ago)
- Language: Python
- Homepage:
- Size: 1.95 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Image Converter (Python)
Image Converter - Python is a lightweight Python script that enables users to convert images between multiple formats, including PNG, JPEG, GIF, and BMP. This tool is designed for simplicity and ease of use in small projects or quick image processing tasks.
## 🚀 Features
- Converts images to/from multiple formats: PNG, JPEG, GIF, BMP.
- Simple and easy-to-use interface.
- Supports batch processing of images (optional with minor modifications).
- Lightweight and minimal dependencies.
## Requirements
- Python 3.6 or higher.
- Pillow library for image processing.
## 🔧 Installation
1. Clone or download the repository:
```bash
git clone https://github.com/marwan-ahmed-23/image-converter-python.git
cd image-converter-python
```
2. Install the required dependencies:
```bash
pip install -r requirements.txt
```
## 📖 Usage
Here's how to use the `image_converter.py` script:
1. Place the image you want to convert in the `images/` directory.
2. Run the script and specify the input file, output file, and format:
```bash
python src/image_converter.py images/input_image.jpg images/output_image.png
```
### Example
```bash
python src/image_converter.py images/example.jpg images/example.png
```
This will convert `example.jpg` to `example.png` and save it in the same directory.
## 📂 Directory Structure
```plaintext
image-converter-python/
├── src/
│ └── image_converter.py
├── images/
├── examples/
│ └── example.py
├── requirements.txt
├── LICENSE
├── .gitignore
└── README.md
```
## 🛠️ Contributing
We welcome contributions! Follow these steps to contribute:
1. Fork the repository.
2. Create a new branch:
```bash
git checkout -b feature-branch
```
3. Make your changes and commit them:
```bash
git commit -m "Add new feature"
```
4. Push to your branch:
```bash
git push origin feature-branch
```
5. Open a Pull Request.
## 🌟 Show Your Support
If you found this project helpful, please consider giving it a ⭐ on GitHub. Your support means the world to us!