{"id":28432266,"url":"https://github.com/x-cod3r/image-converter-resizer","last_synced_at":"2025-06-16T09:35:44.626Z","repository":{"id":296053078,"uuid":"992180533","full_name":"x-cod3r/Image-Converter-Resizer","owner":"x-cod3r","description":"App to resize and convert images or make icons from different type of images","archived":false,"fork":false,"pushed_at":"2025-06-05T13:23:16.000Z","size":1519,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-05T14:24:17.834Z","etag":null,"topics":["convert","ico","icon","image","image-processing","jpeg","png","resize","resize-images"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/x-cod3r.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-28T18:39:29.000Z","updated_at":"2025-06-05T13:23:18.000Z","dependencies_parsed_at":"2025-05-28T20:09:33.465Z","dependency_job_id":null,"html_url":"https://github.com/x-cod3r/Image-Converter-Resizer","commit_stats":null,"previous_names":["x-cod3r/image-converter-resizer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/x-cod3r/Image-Converter-Resizer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x-cod3r%2FImage-Converter-Resizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x-cod3r%2FImage-Converter-Resizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x-cod3r%2FImage-Converter-Resizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x-cod3r%2FImage-Converter-Resizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/x-cod3r","download_url":"https://codeload.github.com/x-cod3r/Image-Converter-Resizer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x-cod3r%2FImage-Converter-Resizer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260133968,"owners_count":22963825,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["convert","ico","icon","image","image-processing","jpeg","png","resize","resize-images"],"created_at":"2025-06-05T16:36:10.704Z","updated_at":"2025-06-16T09:35:44.614Z","avatar_url":"https://github.com/x-cod3r.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🖼️ Bulk Image Converter\n\n\u003cdiv align=\"center\"\u003e\n\n![Python](https://img.shields.io/badge/Python-3.6+-blue.svg)\n![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)\n![License](https://img.shields.io/badge/License-MIT-green.svg)\n![GUI](https://img.shields.io/badge/GUI-Tkinter-orange.svg)\n\n*A powerful, user-friendly GUI tool for bulk image format conversion and resizing*\n\n[Features](#-features) • [Installation](#-installation) • [Usage](#-usage) • [Supported Formats](#-supported-image-formats) • [Screenshots](#-screenshots)\n\n\u003c/div\u003e\n\n---\n\n## ✨ Features\n\n- 🎯 **Intuitive Interface**: Clean, modern GUI with scrollable layout\n- 📦 **Bulk Processing**: Convert multiple images simultaneously\n- 🔄 **Flexible Conversion**: Choose individual formats or batch convert to one format\n- 🖼️ **Format Support**: JPEG, PNG, WebP, BMP, TIFF, ICO, GIF, and HEIC*\n- 📏 **Smart Resizing**: Maintain aspect ratio, custom dimensions, or percentage scaling\n- ⚡ **Quality Control**: Adjustable quality settings for lossy formats\n- 📊 **Progress Tracking**: Real-time conversion progress with detailed status\n- 🛡️ **Error Handling**: Graceful handling of unsupported files and errors\n- 🚀 **Cross-Platform**: Works seamlessly on Windows, macOS, and Linux\n\n*HEIC support requires pillow-heif package\n\n## 🚀 Quick Start\n\n### Prerequisites\n- Python 3.6 or higher\n- PIL/Pillow (for image processing)\n- tkinter (usually included with Python)\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/yourusername/bulk-image-converter.git\n   cd bulk-image-converter\n   ```\n\n2. **Install dependencies**\n   ```bash\n   pip install Pillow\n   # Optional: For HEIC support\n   pip install pillow-heif\n   ```\n\n3. **Run the application**\n   ```bash\n   python image_converter.py\n   ```\n\n### Alternative: Download Release\nDownload the latest release from the [Releases page](https://github.com/yourusername/bulk-image-converter/releases) and run the standalone executable.\n\n## 🎮 Usage\n\n### Basic Workflow\n1. **Launch** the application\n2. **Select Images**: \n   - Click \"Browse Files\" to select individual images\n   - Choose multiple files using Ctrl/Cmd+click\n3. **Choose Output Directory** (optional - defaults to source directory)\n4. **Configure Conversion**:\n   - **Mode 1**: Convert all files to one format\n   - **Mode 2**: Set individual target formats (double-click files)\n5. **Set Quality**: Adjust quality for JPEG/WebP/HEIC (1-100)\n6. **Configure Resizing** (optional):\n   - Keep original size\n   - Custom dimensions with aspect ratio preservation\n   - Percentage scaling\n7. **Convert**: Click \"Convert Images\" and monitor progress\n\n### Advanced Options\n\n#### Conversion Modes\n- **All to One Format**: Convert all selected images to the same format\n- **Individual Selection**: Double-click each file to set its target format\n\n#### Resizing Options\n- **Keep Original**: Maintain original dimensions\n- **Custom Size**: Set specific width/height with optional aspect ratio preservation  \n- **Percentage**: Scale by percentage (e.g., 50% = half size)\n\n## 📋 Supported Image Formats\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd\u003e\n\n**Input Formats**\n- JPEG/JPG\n- PNG\n- BMP\n- TIFF/TIF\n- WebP\n- GIF\n- HEIC/HEIF*\n\n\u003c/td\u003e\n\u003ctd\u003e\n\n**Output Formats**\n- JPEG (with quality control)\n- PNG (lossless)\n- WebP (with quality control)\n- BMP (uncompressed)\n- TIFF (lossless)\n- ICO (multi-size icons)\n- GIF (animated support)\n- HEIC* (with quality control)\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n*Requires `pillow-heif` package: `pip install pillow-heif`\n\n## 📸 Screenshots\n\n### Main Interface\n```\n┌─────────────────────────────────────────────────────────────┐\n│                    Bulk Image Converter                     │\n├─────────────────────────────────────────────────────────────┤\n│ Select Images: [Browse Files] [Clear] - 5 files selected   │\n│                                                             │\n│ Output Directory: [Browse Folder] - Same as source dir     │\n│                                                             │\n│ ┌─ Conversion Settings ────────────────────────────────────┐ │\n│ │ ● All files to one format  ○ Individual format selection│ │\n│ │ Convert to: [JPEG ▼] Quality: [85    ]                  │ │\n│ │                                                          │ │\n│ │ Size Settings:                                           │ │\n│ │ ● Keep original  ○ Custom dimensions  ○ Percentage      │ │\n│ └──────────────────────────────────────────────────────────┘ │\n│                                                             │\n│ ┌─ Selected Files ────────────────────────────────────────┐ │\n│ │ File Name          │ Size   │ Format │ Convert To      │ │\n│ │ ├─ photo1.png      │ 2.1 MB │ PNG    │ JPEG           │ │\n│ │ ├─ image2.heic     │ 3.4 MB │ HEIC   │ JPEG           │ │\n│ │ ├─ scan.tiff       │ 8.7 MB │ TIFF   │ JPEG           │ │\n│ │ └─ logo.gif        │ 156 KB │ GIF    │ JPEG           │ │\n│ └──────────────────────────────────────────────────────────┘ │\n│                                                             │\n│ [████████████████████████████] 100% - Ready                │\n│                                                             │\n│                    [Convert Images]                         │\n└─────────────────────────────────────────────────────────────┘\n```\n\n## 🛠️ Configuration Options\n\n| Setting | Description | Options |\n|---------|-------------|---------|\n| **Conversion Mode** | How to handle target formats | All to one format / Individual selection |\n| **Output Format** | Target image format | JPEG, PNG, WebP, BMP, TIFF, ICO, GIF, HEIC* |\n| **Quality** | Compression quality (lossy formats) | 1-100 (higher = better quality) |\n| **Size Mode** | How to handle image dimensions | Keep original / Custom size / Percentage |\n| **Aspect Ratio** | Maintain proportions when resizing | Enabled / Disabled |\n\n## 🎯 Use Cases\n\n- **Web Optimization**: Convert images to WebP for faster loading\n- **Icon Creation**: Generate ICO files with multiple sizes for applications\n- **Batch Processing**: Convert camera RAW files to standard formats\n- **Size Reduction**: Compress images for email or storage\n- **Format Migration**: Convert legacy formats to modern ones\n- **Social Media**: Resize images for different platform requirements\n\n## 🔧 Technical Details\n\n### Quality Settings\n- **JPEG**: 1-100 (recommended: 85-95 for photos, 75-85 for web)\n- **WebP**: 1-100 (typically 10-15% smaller than JPEG at same quality)\n- **HEIC**: 1-100 (Apple's format, excellent compression)\n\n### ICO Generation\n- Automatically creates multi-size icons: 16×16, 32×32, 48×48, 64×64, 128×128, 256×256\n- Perfect for Windows applications and favicons\n\n### Threading\n- Non-blocking UI with background processing\n- Real-time progress updates\n- Graceful error handling per file\n\n## 🤝 Contributing\n\nContributions welcome! Areas for improvement:\n\n1. **Fork** the repository\n2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)\n3. **Commit** changes (`git commit -m 'Add amazing feature'`)\n4. **Push** to branch (`git push origin feature/amazing-feature`)\n5. **Open** a Pull Request\n\n### Ideas for Contributions\n- 🎨 Modern UI themes and dark mode\n- 📱 Additional format support (AVIF, JXL)\n- 🔧 Command-line interface\n- 🌍 Internationalization\n- 📊 Batch statistics and reporting\n- 🖼️ Image preview functionality\n- 🎛️ Advanced filtering options\n\n## 🐛 Bug Reports \u0026 Feature Requests\n\nFound a bug? Have an idea? Open an issue on the [Issues page](https://github.com/yourusername/bulk-image-converter/issues).\n\n**Bug Report Template:**\n- Python version and OS\n- PIL/Pillow version\n- Input image format and size\n- Steps to reproduce\n- Error message (if any)\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- Built with Python's Pillow library for robust image processing\n- Uses tkinter for cross-platform GUI compatibility\n- HEIC support via pillow-heif library\n- Inspired by the need for simple bulk image processing tools\n\n## 📊 Performance\n\n- **Speed**: Processes 100+ images efficiently with threading\n- **Memory**: Optimized memory usage with image streaming\n- **Quality**: Preserves image quality with smart compression\n- **Compatibility**: Handles various color modes and transparency\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\u003cstrong\u003eMade with ❤️ for photographers, designers, and developers\u003c/strong\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fx-cod3r%2Fimage-converter-resizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fx-cod3r%2Fimage-converter-resizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fx-cod3r%2Fimage-converter-resizer/lists"}