🎨 Image Converter Pro

A professional, feature-rich image conversion tool built with PySide6

Transform your images with ease - Modern formats, Batch processing, Smart presets

🚀 Features • 📥 Installation • 📖 Usage • 🖼️ Screenshots • 🤝 Contributing

🖼️ Screenshots

Single Conversion Mode
Clean, modern dark theme with intuitive controls

Batch Processing
Process hundreds of images with real-time progress tracking

Advanced Adjustments
Fine-tune brightness, contrast, saturation, and sharpness

✨ Features

🎯 Modern Format Support

📸 JPEG - Universal photo format
🖼️ PNG - Lossless with transparency
🌐 WebP - 25-34% smaller than JPEG
⚡ AVIF - Next-gen compression
🍎 HEIC - iPhone photo format
🎬 GIF - Animated images
🖨️ TIFF - Professional quality
📄 BMP, ICO, PDF - Additional formats

⚡ Core Capabilities

🔄 Single & Batch Conversion
🎯 Drag & Drop Support
⏯️ Pause/Resume/Stop Controls
📊 Real-time Progress Tracking
💾 Smart Preset System
🎨 Image Adjustments
🔍 Metadata Management
⌨️ Keyboard Shortcuts

💎 Smart Preset System

Save your favorite settings as reusable presets:

Preset	Description	Best For
📱 Web Optimization	WebP format, compressed, metadata stripped	Website delivery
📷 Social Media	JPG 1080×1080, high quality	Instagram/Facebook
🖨️ Print Quality	Lossless TIFF, maximum resolution	Professional printing
📧 Email Friendly	Small file size, optimized	Email attachments
🔒 Privacy Safe	All metadata removed including GPS	Public sharing

🎛️ Professional Image Adjustments

Brightness
_{Lighten or darken}

Contrast
_{Enhance details}

Saturation
_{Adjust colors}

Sharpness
_{Add clarity}

Additional Features:

📐 Resize with aspect ratio lock
🔄 Multiple resampling methods (Lanczos, Bicubic, Bilinear, Nearest)
📊 Quality control with real-time preview
🔐 Privacy controls for metadata

📥 Installation

📋 Prerequisites

Required: Python 3.8 or higher | pip package manager

🔧 Installation Steps

Step 1: Clone the Repository

git clone https://github.com/yourusername/image-converter-pro.git
cd image-converter-pro

Step 2: Install Dependencies

Essential packages (required):

pip install PySide6 Pillow

Optional packages (for advanced formats):

# For AVIF support (recommended)
pip install pillow-avif-plugin

# For HEIC/HEIF support (iPhone photos)
pip install pillow-heif

Step 3: Run the Application

python main.py

💡 Tip: Create a virtual environment first:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt

📖 Usage

🚀 Quick Start Guide

🖼️ Single Image Conversion (Click to expand)

1. Load an Image

Click "Select Image" button
OR Press Ctrl+O
OR Drag & drop an image into the preview area

2. Choose Format

Select output format from dropdown
View format description and recommendations

3. Adjust Settings (Optional)

🎚️ Quality: Adjust slider for lossy formats
📏 Resize: Enable resize and set dimensions
🎨 Adjustments: Fine-tune image properties
📋 Metadata: Configure EXIF data handling

4. Convert

Click "Convert & Save" or press F5
Choose output location
✅ Done!

📦 Batch Processing (Click to expand)

1. Add Images

Click "Add Files" to select multiple images
OR Click "Add Folder" to add all images from a directory
OR Drag & drop multiple files

2. Configure Settings

Settings from Single Conversion tab apply to batch
OR Load a preset for consistent processing

3. Process

Click "Process Batch" to start
Monitor real-time progress
Use Pause/Resume/Stop controls as needed

⌨️ Keyboard Shortcuts

Shortcut	Action
`Ctrl`+`O`	Open Image
`Ctrl`+`Shift`+`O`	Open Multiple Images
`Ctrl`+`S`	Save/Convert
`F5`	Convert Image
`Ctrl`+`B`	Add to Batch
`Ctrl`+`Shift`+`C`	Clear Batch Queue
`Ctrl`+`Q`	Quit Application
`F1`	Show Keyboard Shortcuts
`+` / `-`	Zoom In/Out Preview

💡 Usage Tips

📊 Format Recommendations

🌐 For Web Use

Use WebP at 80-85% quality for best size/quality balance
Or AVIF at 70-80% for cutting-edge compression
Modern browsers support both formats (93%+ coverage)

🎨 For Photos with Transparency

Use PNG for lossless quality
Or WebP for smaller file size with transparency support

🖨️ For Maximum Quality

Use TIFF or PNG (both lossless)
Perfect for archival and professional printing

📧 For Email/Sharing

Use JPEG at 75-80% quality
Enable resize to 1280×720 or smaller
Use "Email Friendly" preset for optimal settings

📱 For Social Media

Instagram/Facebook: JPEG at 90% quality, 1080×1080 or 1920×1080
Use the "Social Media" preset for optimal settings

🔒 Privacy & Metadata

⚠️ Important Privacy Tips:

✅ Strip GPS when sharing photos publicly to protect your location
👀 View Metadata before stripping to preserve important information
💾 Preserve EXIF for archival purposes (camera settings, dates)
ℹ️ Some formats (PNG, BMP) have limited EXIF support

📦 Batch Processing Best Practices

1. 🧪 Test First       → Process 1-2 sample images to verify settings
2. 💾 Use Presets      → Create presets for common workflows
3. 👀 Monitor Progress → Watch the first few conversions for errors
4. 💽 Check Disk Space → Large batches require significant storage
5. ✅ Review Results   → Enable "Open folder after save" to check output

🗂️ Project Structure

image-converter-pro/
│
├── 📄 main.py                 # Main application entry point
├── ⚙️ config.py               # Configuration and preset management
├── 📋 formats.py              # Format definitions and detection
├── 🔧 processor.py            # Image processing engine
├── 🔄 batch_processor.py      # Batch processing with threading
│
├── 📖 README.md               # This file
├── 📦 requirements.txt        # Python dependencies
├── 📜 LICENSE                 # MIT License
│
└── 📁 screenshots/            # Application screenshots
    ├── main-interface.png
    ├── batch-processing.png
    └── adjustments.png

🛠️ Technical Details

🏗️ Built With

PySide6
_{Qt for Python UI}

Pillow
_{Image Processing}

Python 3.8+
_{Programming Language}

🏛️ Architecture

🧩 Modular Design - Separated concerns for maintainability
🧵 Threading - QThread for non-blocking batch processing
📡 Signal/Slot - Event-driven architecture
💾 JSON Config - Persistent settings and presets
📝 Type Hints - Full type annotation for code clarity

💻 System Requirements

Minimum	Recommended
Python 3.8+ 4GB RAM 100MB disk space	Python 3.10+ 8GB RAM SSD storage Multi-core CPU

🐛 Troubleshooting

⚠️ Common Issues

❌ "AVIF format not supported"

pip install pillow-avif-plugin

❌ "HEIC format not supported"

pip install pillow-heif

❌ "WebP format not supported"

pip install pillow[webp]

❌ "Module not found: PySide6"

pip install PySide6

❌ "No module named PIL"

pip install Pillow

🐌 Performance Issues

Issue	Solution
Slow batch processing	Reduce batch size or disable adjustments
High memory usage	Enable resize for very large images
Slow preview	Disable real-time adjustments for large files

🤝 Contributing

Contributions are welcome! Here's how you can help:

📝 Contribution Process

# 1. Fork the Repository
# 2. Create a Feature Branch
git checkout -b feature/AmazingFeature

# 3. Commit Your Changes
git commit -m 'Add some AmazingFeature'

# 4. Push to the Branch
git push origin feature/AmazingFeature

# 5. Open a Pull Request

💡 Ideas for Contributions

🆕 Add new image formats (JPEG XL, JXR)
🎨 Implement additional filters (blur, edge detection)
🏷️ Add watermarking functionality
☀️ Create light theme option
⚡ Improve batch processing performance
☁️ Add cloud storage integration
↩️ Implement undo/redo for settings
🖥️ Add command-line interface
🔌 Create plugin system

📝 License

This project is licensed under the MIT License.

View Full License

MIT License

Copyright (c) 2025 Image Converter Pro

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

🙏 Acknowledgments

🎨
XnConvert & IrfanView
_{Feature Inspiration}

🎭
Material Design
_{Design Principles}

🖼️
Pillow Team
_{Image Library}

⚡
Qt Project
_{UI Framework}

📞 Support

Report Bugs
GitHub Issues

Documentation
Usage Guide

Get Help
Troubleshooting

🗓️ Changelog

Version 1.0.0 (2025)

+ Initial release
+ Single and batch conversion
+ Modern dark theme interface
+ Support for 10+ image formats
+ Image adjustments (brightness, contrast, saturation, sharpness)
+ Preset system with 5 built-in presets
+ Metadata viewer and privacy controls
+ Comprehensive keyboard shortcuts
+ Multi-threaded batch processing
+ Drag & drop support

🌟 Star History

If you find this project useful, please consider giving it a star! ⭐

Made with ❤️ and Python

⬆ Back to Top

# 🎨 Image Converter Pro

A professional, feature-rich image conversion tool built with PySide6

Features • Installation • Usage • Screenshots • Contributing

📸 Screenshots

Main Interface - Single Conversion

Clean, modern dark theme with intuitive controls

Batch Processing

Process hundreds of images at once with real-time progress tracking

Image Adjustments

Fine-tune brightness, contrast, saturation, and sharpness

✨ Features

🎯 Modern Format Support

JPEG - Universal photo format with adjustable quality
PNG - Lossless compression with transparency support
WebP - Modern web format (25-34% smaller than JPEG)
AVIF - Next-gen format with superior compression (93%+ browser support)
HEIC - Apple's iPhone photo format (read-only for conversion)
GIF - Animated images with transparency
TIFF - Professional/print quality format
BMP, ICO, PDF - Additional format support

⚡ Core Capabilities

Single & Batch Conversion

Convert one image or process hundreds at once
Drag & drop support for quick workflows
Real-time progress tracking with pause/resume/stop controls
Visual success/failure indicators

Smart Preset System

Save your favorite settings as reusable presets:

📱 Web Optimization - WebP format, compressed, metadata stripped
📷 Social Media - Perfect for Instagram/Facebook
🖨️ Print Quality - Lossless TIFF, maximum resolution
📧 Email Friendly - Optimized file size for attachments
🔒 Privacy Safe - All metadata removed including GPS

Professional Image Adjustments

Brightness - Lighten or darken images
Contrast - Enhance or reduce contrast
Saturation - Adjust color intensity
Sharpness - Add or reduce sharpness
Resize - Scale images with aspect ratio lock
Resampling - Choose from Lanczos, Bicubic, Bilinear, or Nearest

Advanced Features

🔍 Metadata Viewer - View and manage EXIF data
🔐 Privacy Controls - Strip GPS location while preserving other data
📊 Quality Control - Adjustable quality slider with real-time feedback
🎨 Dark Theme - Modern, professional interface
⌨️ Keyboard Shortcuts - Full keyboard navigation support
📁 Smart File Management - Recent files, custom output folders

🚀 Installation

Prerequisites

Python 3.8 or higher
pip (Python package manager)

Step 1: Clone the Repository

git clone https://github.com/yourusername/image-converter-pro.git
cd image-converter-pro

Step 2: Install Dependencies

Essential packages:

pip install PySide6 Pillow

Optional - Advanced format support:

# For AVIF support (recommended)
pip install pillow-avif-plugin

# For HEIC/HEIF support (iPhone photos)
pip install pillow-heif

Step 3: Run the Application

python main.py

📖 Usage

Quick Start Guide

Single Image Conversion

Load an Image
- Click "Select Image" or press Ctrl+O
- Or drag & drop an image into the preview area
Choose Format
- Select your desired output format from the dropdown
- View format description and recommendations
Adjust Settings (Optional)
- Set quality level for lossy formats
- Enable resize and set dimensions
- Fine-tune brightness, contrast, saturation, sharpness
- Configure metadata options
Convert
- Click "Convert & Save" or press F5
- Choose output location
- Done! 🎉

Batch Processing

Add Images
- Switch to "Batch Processing" tab
- Click "Add Files" to select multiple images
- Or click "Add Folder" to add all images from a directory
- Or drag & drop multiple files
Configure Settings
- Settings from Single Conversion tab apply to all images
- Or load a preset for consistent processing
Process
- Click "Process Batch"
- Monitor real-time progress
- Use Pause/Resume/Stop controls as needed

Keyboard Shortcuts

Shortcut	Action
`Ctrl+O`	Open Image
`Ctrl+Shift+O`	Open Multiple Images
`Ctrl+S`	Save/Convert
`F5`	Convert Image
`Ctrl+B`	Add to Batch
`Ctrl+Shift+C`	Clear Batch Queue
`Ctrl+Q`	Quit Application
`F1`	Show Keyboard Shortcuts
`+` / `-`	Zoom In/Out Preview

💡 Usage Tips

Format Recommendations

For Web Use:

Use WebP at 80-85% quality for best size/quality balance
Or AVIF at 70-80% for cutting-edge compression

For Photos with Transparency:

Use PNG for lossless quality
Or WebP for smaller file size

For Maximum Quality:

Use TIFF or PNG (lossless)

For Email/Sharing:

Use JPEG at 75-80% quality
Enable resize to 1280x720 or smaller

For Social Media:

Instagram/Facebook: JPEG at 90% quality, 1080x1080 or 1920x1080
Use the "Social Media" preset for optimal settings

Batch Processing Best Practices

Test First - Process 1-2 sample images to verify settings
Use Presets - Create presets for common workflows
Monitor Progress - Watch the first few conversions for errors
Check Disk Space - Large batches require significant storage
Review Results - Enable "Open folder after save" to check output

Privacy & Metadata

Strip GPS when sharing photos publicly to protect your location
View Metadata before stripping to preserve important information
Preserve EXIF for archival purposes (camera settings, dates)
Some formats (PNG, BMP) have limited EXIF support

🗂️ Project Structure

image-converter-pro/
├── main.py                 # Main application entry point
├── config.py              # Configuration and preset management
├── formats.py             # Format definitions and detection
├── processor.py           # Image processing engine
├── batch_processor.py     # Batch processing with threading
├── README.md              # This file
├── requirements.txt       # Python dependencies
├── screenshots/           # Application screenshots
│   ├── main-interface.png
│   ├── batch-processing.png
│   └── adjustments.png
└── LICENSE               # MIT License

🛠️ Technical Details

Built With

PySide6 - Qt for Python (UI framework)
Pillow (PIL) - Python Imaging Library (image processing)
Python 3.8+ - Programming language

Architecture

Modular Design - Separated concerns for maintainability
Threading - QThread for non-blocking batch processing
Signal/Slot - Event-driven architecture
JSON Config - Persistent settings and presets
Type Hints - Full type annotation for code clarity

System Requirements

Minimum:

Python 3.8+
4GB RAM
100MB disk space

Recommended:

Python 3.10+
8GB RAM
SSD for faster processing
Multi-core CPU for batch operations

🐛 Troubleshooting

Format Support Issues

"AVIF format not supported"

pip install pillow-avif-plugin

"HEIC format not supported"

pip install pillow-heif

"WebP format not supported"

pip install pillow[webp]

Performance Issues

Slow batch processing - Reduce batch size or enable fewer adjustments
High memory usage - Enable resize for very large images
Slow preview - Disable real-time adjustments for large files

Common Errors

"Module not found: PySide6"

pip install PySide6

"No module named PIL"

pip install Pillow

"Image fails to convert"

Check if output format is writable (HEIC is read-only)
Verify disk space is available
Try converting to a different format

🤝 Contributing

Contributions are welcome! Here's how you can help:

Fork the Repository
Create a Feature Branch
```
git checkout -b feature/AmazingFeature
```
Commit Your Changes
```
git commit -m 'Add some AmazingFeature'
```
Push to the Branch
```
git push origin feature/AmazingFeature
```
Open a Pull Request

Ideas for Contributions

Add new image formats (JPEG XL, JXR, etc.)
Implement additional filters (blur, edge detection, etc.)
Add watermarking functionality
Create light theme option
Improve batch processing performance
Add cloud storage integration
Implement undo/redo for settings
Add command-line interface
Create plugin system for extensions

📝 License

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

MIT License

Copyright (c) 2025 Image Converter Pro

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

🙏 Acknowledgments

XnConvert & IrfanView - Inspiration for features and workflow
Material Design - Color palette and design principles
Pillow Team - Excellent image processing library
Qt Project - Powerful cross-platform UI framework

📞 Support

Issues - Report bugs via GitHub Issues
Documentation - Check this README for detailed information
Dependencies - Verify all packages are installed correctly

🗓️ Changelog

Version 1.0.0 (2025)

🎉 Initial release
✨ Single and batch conversion
🎨 Modern dark theme interface
📦 Support for 10+ image formats (JPEG, PNG, WebP, AVIF, HEIC, etc.)
🎛️ Image adjustments (brightness, contrast, saturation, sharpness)
📋 Preset system with 5 built-in presets
🔍 Metadata viewer and privacy controls
⌨️ Comprehensive keyboard shortcuts
🧵 Multi-threaded batch processing
📱 Drag & drop support

🌟 Star History

If you find this project useful, please consider giving it a star! ⭐

Made with ❤️ and Python

⬆ Back to Top

Name		Name	Last commit message	Last commit date
Latest commit History 9 Commits
LICENSE		LICENSE
README.md		README.md
Read_me.md		Read_me.md
batch_processor.py		batch_processor.py
config.py		config.py
formats.py		formats.py
image_converter_config.json		image_converter_config.json
main.py		main.py
main_interface.png		main_interface.png
processor.py		processor.py

License

esprit112/image-converter

Folders and files

Latest commit

History

Repository files navigation

🎨 Image Converter Pro

A professional, feature-rich image conversion tool built with PySide6

🖼️ Screenshots

✨ Features

🎯 Modern Format Support

⚡ Core Capabilities

💎 Smart Preset System

🎛️ Professional Image Adjustments

📥 Installation

📋 Prerequisites

🔧 Installation Steps

Step 1: Clone the Repository

Step 2: Install Dependencies

Step 3: Run the Application

📖 Usage

🚀 Quick Start Guide

⌨️ Keyboard Shortcuts

💡 Usage Tips

📊 Format Recommendations

🔒 Privacy & Metadata

📦 Batch Processing Best Practices

🗂️ Project Structure

🛠️ Technical Details

🏗️ Built With

🏛️ Architecture

💻 System Requirements

🐛 Troubleshooting

⚠️ Common Issues

🐌 Performance Issues

🤝 Contributing

📝 Contribution Process

💡 Ideas for Contributions

📝 License

🙏 Acknowledgments

📞 Support

🗓️ Changelog

Version 1.0.0 (2025)

🌟 Star History

Made with ❤️ and Python

📸 Screenshots

Main Interface - Single Conversion

Batch Processing

Image Adjustments

✨ Features

🎯 Modern Format Support

⚡ Core Capabilities

Single & Batch Conversion

Smart Preset System

Professional Image Adjustments

Advanced Features

🚀 Installation

Prerequisites

Step 1: Clone the Repository

Step 2: Install Dependencies

Step 3: Run the Application

📖 Usage

Quick Start Guide

Single Image Conversion

Batch Processing

Keyboard Shortcuts

💡 Usage Tips

Format Recommendations

Batch Processing Best Practices

Privacy & Metadata

🗂️ Project Structure

🛠️ Technical Details

Built With

Architecture

System Requirements

🐛 Troubleshooting

Format Support Issues

Performance Issues

Common Errors

🤝 Contributing

Packages