Skip to content

MohdYahyaMahmodi/image-forge

Repository files navigation

Image Forge

Image Forge Home

Demo Site | Features | How It Works | Getting Started | Usage | Performance | Roadmap | FAQ | License | Contributing

Version License Follow @mohdmahmodi

Advanced Client-Side Image Conversion and Optimization Tool


Key Features

  • Universal Input Support: Accept any image format supported by your browser, including JPEG, PNG, GIF, WebP, SVG, and more.
  • Versatile Output Formats: Convert to JPEG, PNG, or WebP with customizable quality settings.
  • Client-Side Processing: All conversions happen directly in your browser, ensuring speed and privacy.
  • Bulk Conversion: Process hundreds of images simultaneously, saving time and effort.
  • Real-time Statistics: Get instant insights into file sizes, formats, and conversion ratios.
  • Efficient Compression: Reduce file sizes significantly while maintaining image quality.
  • Responsive Design: Seamless experience across desktop, tablet, and mobile devices.
  • Dark Mode: Optimized for extended use and night-time conversions.
  • Privacy-Focused: Your images never leave your device, ensuring complete data security.

How It Works

Image Forge leverages cutting-edge web technologies to provide a seamless image conversion experience:

  1. File Selection: Drag & drop or select images using the intuitive file picker.
  2. Preview & Analysis: View your selected images in a sleek carousel and get detailed file information.
File Details
  1. Conversion Setup: Choose your desired output format (JPEG, PNG, or WebP) and adjust quality settings if needed.
  2. Processing: Images are converted client-side using advanced HTML5 Canvas technology and Web Workers for optimal performance.
  3. Compression: State-of-the-art algorithms optimize file sizes without significant quality loss.
  4. Download: Converted images are packaged into a convenient zip file for easy downloading and sharing.

Getting Started

To run Image Forge locally, follow these steps:

# Clone the repository
git clone https://github.com/mohdyahyamahmodi/image-forge.git

# Navigate to the project directory
cd image-forge

# Open index.html in your preferred browser
open index.html

No server setup or complex configuration required. Image Forge runs entirely in your browser, ensuring a hassle-free setup process.

Usage

  1. Upload Images:

    • Drag and drop images onto the designated area, or
    • Click "Select Files" to use the file picker
  2. Review Statistics: Analyze the detailed breakdown of your uploaded images, including total size, formats, and more.

Image Statistics
  1. Choose Format: Select your desired output format (JPEG, PNG, or WebP) from the dropdown menu. Each format offers unique benefits:

    • JPEG: Best for photographs and complex images with gradients
    • PNG: Ideal for images with transparency or sharp edges
    • WebP: Modern format offering superior compression and quality
  2. Convert: Click the "Convert Images" button to start processing. Monitor the progress in real-time.

Conversion Progress
  1. Download: Once conversion is complete, download your optimized images as a zip file and view the conversion results.
Conversion Results

Performance

Image Forge is designed for efficiency and quality. While performance can vary based on your device's capabilities, here's what you can expect:

  • Bulk Processing: Successfully tested with 400 images on a low-spec machine
  • Processing Time: Approximately 30 seconds for 400 images
  • Size Reduction: Achieve up to 70-90% file size reduction depending on the input images and chosen output format

Note: Actual results may vary depending on the number of images, their sizes, your device's specifications, and browser performance. Image Forge utilizes your device's resources efficiently to provide the best possible performance.

Upcoming Features

We're constantly working to improve Image Forge and add new capabilities. Here's a preview of some exciting features in development:

  • Image Filters: Apply a variety of filters to enhance or stylize your images before conversion.
  • Rotate and Flip: Easily adjust image orientation with rotation and flip tools.
  • Resize Options: Scale your images up or down to specific dimensions or percentages.
  • AI-Powered Upscaling: Enhance image resolution using cutting-edge machine learning algorithms.
  • Additional Output Formats: Support for more specialized formats like AVIF, HEIF, and lossless WebP.
  • Batch Editing: Apply the same edits to multiple images simultaneously.
  • Advanced Compression Settings: Fine-tune compression levels for each format to balance quality and file size.
  • Custom Watermarking: Add text or image watermarks to your converted images.

FAQ

Is there a limit to how many images I can process? There's no hard limit set by Image Forge. The practical limit depends on your device's capabilities (RAM, processing power) and browser limitations. We've successfully tested with 400 images on a low-spec machine, but more powerful devices can handle even larger batches.
What input formats are supported? Image Forge can accept any image format that your browser supports. This typically includes common formats like JPEG, PNG, GIF, WebP, SVG, and many others. If your browser can display it, Image Forge can likely process it.
What output formats are available? Currently, Image Forge supports conversion to three formats: JPEG, PNG, and WebP. These formats offer a good balance of compatibility and efficiency for most use cases. We're constantly evaluating new formats to add based on user needs and browser support.
Is my data safe? Absolutely. All processing happens in your browser. Your images never leave your device, ensuring maximum privacy and security. We take data protection seriously and have designed Image Forge with privacy as a top priority.
Can I use Image Forge for commercial projects? Yes. Image Forge is released under the MIT License, which allows for both personal and commercial use. Feel free to use it in your projects, both personal and professional. Please refer to the LICENSE file for full details on the terms of use.
How does Image Forge compare to server-based conversion tools? Image Forge offers several advantages over server-based tools: 1. Privacy: Your images never leave your device. 2. Speed: No upload/download times, conversions happen instantly. 3. No file size limits: Process as many images as your device can handle. 4. Offline capability: Use Image Forge without an internet connection once the page is loaded.

License

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

Contributing

Contributions to Image Forge are always welcome. Whether it's bug fixes, new features, or improvements to the documentation, your help is appreciated.

Please read our CONTRIBUTING.md for details on how to contribute to this project.

We look forward to your contributions!


Developed by Mohd Mahmodi

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published