A powerful and modern desktop application for batch image processing, PDF generation, and icon creation.
Formato is a professional-grade image processing suite built with Python and CustomTkinter. It combines advanced batch conversion, optimized live preview, EXIF metadata editing, watermarking, multi-frame GIF preservation, PDF exporting, and multi-size icon generation into a unified, user-friendly desktop experience.
Designed and developed by MRThugh, Formato demonstrates modern Python desktop engineering utilizing multithreading, system-level drag-and-drop integration, and optimized pipeline-oriented rendering.
- Convert images in bulk to JPEG, PNG, WEBP, TIFF, BMP, and GIF.
- Fully multithreaded engine utilizing a thread pool for parallel operations.
- Drag & Drop support to load hundreds of files instantly.
- Live progress tracking with individual progress bars for each queued item.
- Real-time Thumbnails: Generates a lightweight 40x40 visual thumbnail for each file in the queue.
- Individual File Removal: Remove single files from the list instantly using the
❌button without clearing the whole queue.
- Pre-Scaled Processing: Automatically downscales high-resolution images to a lightweight proxy size before applying enhancements, removing UI lag even on large 4K or RAW files.
- Real-time previews of adjustments, watermarks, resizing modes, and filters.
- Debounced preview thread rendering to save processing overhead during slider drags.
- Stretch: Force coordinates to exact custom dimensions.
- Fit (Maintain AR): Resize cleanly within bounds without stretching.
- Fill / Crop: Automatically fill dimensions and crop out excessive margins.
- Keeps original aspect ratio intact automatically if only one dimension is entered.
- Precision sliders for Brightness, Contrast, Saturation, and Sharpness.
- Quick double-click to reset sliders back to the initial
1.0value. - Filters: Grayscale conversion, Image Sharpen, and Auto-Contrast.
- Compress target outputs down to a specific size in KB.
- Utilizes an in-memory binary search quality optimizer (
io.BytesIO) to protect SSD/HDD from redundant writes.
- Supports PNG logo watermarks with transparency overlay.
- Position presets (Top-Left, Top-Right, Bottom-Left, Bottom-Right, Center).
- Seamless opacity, size, and margin configuration.
- Monochrome-Safe Mode: Seamlessly handles watermarks on Grayscale (
Lmode) canvasses by managing temporary color spaces without corrupting the alpha channels.
- Preserve original camera EXIF data.
- Expanded EXIF Compiler: Inject custom values for Author/Artist, Copyright Info, and Image Description/Caption directly into standard EXIF headers (Tags 315, 33432, 270).
- Combine multiple images in the queue into a single PDF document.
- Safely flattens transparent PNG elements over a white solid canvas to avoid PDF transparency conversion errors.
- Export multiple PNG icon sizes alongside native
.icomaster files. - Presets optimized for Web Favicons or Desktop Application requirements.
- Save current slider values, text configurations, and dimensions to a local JSON file.
- Load custom configurations instantly for a faster workflow.
| Input Format | Output Format | Dynamic Frame Preservation (GIF) |
|---|---|---|
| JPG / JPEG | JPEG, PNG, WEBP, TIFF, BMP, GIF | N/A |
| PNG | JPEG, PNG, WEBP, TIFF, BMP, GIF | N/A |
| WEBP | JPEG, PNG, WEBP, TIFF, BMP, GIF | N/A |
| TIFF | JPEG, PNG, WEBP, TIFF, BMP, GIF | N/A |
| BMP | JPEG, PNG, WEBP, TIFF, BMP, GIF | N/A |
| GIF | JPEG, PNG, WEBP, TIFF, BMP, GIF | Yes (Full frame-by-frame animation processed & preserved) |
- Python 3.10+: Core programming language.
- CustomTkinter: Modern dark-themed responsive desktop GUI wrapper.
- Pillow (PIL): High-performance advanced image processing, canvas operations, EXIF compiler, and multi-frame parsing.
- TkinterDnD2: Native cross-platform drag-and-drop file subsystem integration.
To run Formato locally, clone the repository and install the dependencies:
git clone https://github.com/MRThugh/Formato-Image-Converter.git
cd Formato-Image-Converter
pip install -r requirements.txt
python main.pySave the following requirements to your requirements.txt file:
customtkinter>=5.2.0
Pillow>=10.0.0
tkinterdnd2>=0.3.0- Object-Oriented Design: Clear segregation of GUI states, helper functions, and background threads.
- Pre-Processing Validations: Actively validates the queue, verifies output folder path presence, and tests disk write permissions by writing/removing temporary tokens before spawning conversion threads.
- Asynchronous Execution: Thread Pool Executor ensures multiple large image files are processed concurrently without freezing the main application thread.
Instead of committing multiple experimental files to disk, Formato handles binary search iterations within RAM using memory streams (io.BytesIO). It evaluates file output sizes against the target KB threshold and commits to storage only once when the optimal quality setting is calculated.
During live adjustments, Formato dynamically downsamples the target image workspace to an optimal thumbnail size on a separate thread. This design removes rendering pipeline bottlenecks and ensures adjustments are instantaneous and smooth.
For animated GIFs, Formato tracks active frames, extracts, transforms, applies adjustments and watermarks to each frame individually, and compiles them back together while accurately preserving loop count and frame-rate durations.
Formato was created to provide:
- A modern desktop GUI/UX following professional dark UI design principles.
- Efficient, optimized, and multi-threaded processing of complex file operations.
- A practical, real-world utility demonstrating advanced Python engineering, clean code architecture, and efficient asset handling.
Ali Kamrani
- GitHub: MRThugh
Formato is more than a batch converter. It is a production-ready showcase of:
- Software engineering principles and asynchronous programming.
- Rigorous input/validation testing and reliable exception handling.
- Advanced layout engineering with GUI frameworks.
- Complete image editing pipeline design (filters, transforms, watermarks, metadata, and container building).
This project is licensed under the MIT License.
If you find this project useful or educational, please consider giving the repository a star on GitHub.
Built with passion by Ali Kamrani (MRThugh)
```