Skip to content

bavamont/imageoptimizer

Repository files navigation

Image Optimizer

A professional desktop application for batch image processing, optimization, and combination. Built with Electron and powered by libvips for lightning-fast, high-quality image processing.

Features

Image Processing

  • Processing Chains - Build custom workflows by dragging and dropping processing steps in desired order
  • Batch Processing - Process hundreds of images simultaneously with real-time progress tracking
  • Format Conversion - Convert between JPEG, PNG, WebP, TIFF, and AVIF formats with quality control
  • Smart Resizing - Multiple resize modes including fit (maintain aspect ratio), fill (may crop), stretch (ignore aspect ratio), and contain (fit with background)
  • Image Enhancement - Adjust brightness, contrast, and saturation with precise control
  • Filter Effects - Apply blur, sharpen, grayscale, sepia, vintage, noir, warm, and cool filters with adjustable intensity
  • Image Cropping - Crop images with preset aspect ratios (1:1 square, 16:9 landscape, 9:16 portrait, 4:3 classic, 4:5 social) or custom dimensions with offset control
  • Rotate & Flip - Rotate images in 90° increments and flip horizontally or vertically
  • Watermarking - Add text or image watermarks with precise positioning and opacity control
  • AI Upscaling - Enhance image resolution using Real-ESRGAN models for 2x and 4x scaling
  • EXIF Management - Preserve or remove image metadata

Image Combination

  • Multi-Image Combiner - Combine multiple images into a single output image
  • PDF Page Extraction - Extract and combine pages from PDF files with high quality
  • Flexible Alignment - Choose vertical (stacked) or horizontal (side-by-side) layouts
  • Custom Spacing - Adjust pixel spacing between combined images
  • Maximum Dimensions - Set output size limits with automatic intelligent scaling
  • Background Control - Customize background color for combined images
  • Mixed Input Support - Combine images and PDF pages in the same operation

Advanced Features

  • AI Image Upscaling - AI-powered image enhancement using Real-ESRGAN models for 2x and 4x upscaling with intelligent quality improvement
  • Watermark Overlay - Add text or image watermarks with customizable position, opacity, font, and colors
  • EXIF Management - Preserve or remove image metadata
  • Batch Rename - Pattern-based renaming with counters, date/time stamps, and case control
  • Recent Folders - Quick access to frequently used directories
  • Settings Persistence - All preferences automatically saved and restored

File Management

  • Drag & Drop Interface - Simply drag files or entire folders into the application
  • Flexible Output - Save to source folders or custom output directories
  • Folder Structure - Preserve original directory hierarchy or flatten structure
  • Subdirectory Processing - Include or exclude subdirectories with full control
  • Non-Image File Handling - Copy non-image files to output directory when needed
  • Smart Organization - Create subfolders for organized output

User Experience

  • Modern Interface - Clean, intuitive design with glass-morphism effects
  • Start Page - Welcome screen with quick access to main functions
  • Multi-Language Support - Available in English and German with automatic detection
  • Cross-Platform Shortcuts - Keyboard shortcuts that work on Windows, macOS, and Linux
  • Real-Time Progress - Live progress tracking with time estimation and detailed statistics
  • Auto-Updates - Automatic update checking and installation
  • Comprehensive Help - Built-in documentation with keyboard shortcuts and troubleshooting

Supported Formats

Input Formats

  • JPEG (.jpg, .jpeg) - Universal photo format
  • PNG (.png) - Lossless format with transparency support
  • WebP (.webp) - Modern web format with excellent compression
  • TIFF (.tiff, .tif) - High-quality archival format
  • GIF (.gif) - Animated and static images (read only)
  • AVIF (.avif) - Next-generation format with superior compression
  • SVG (.svg) - Vector graphics (read only)
  • PDF (.pdf) - Extract pages as high-quality images

Output Formats

  • JPEG (.jpg) - Best for photos with adjustable compression
  • PNG (.png) - Best for images requiring transparency
  • WebP (.webp) - Modern format with superior compression and quality
  • TIFF (.tiff) - Lossless format for archival purposes
  • AVIF (.avif) - Next-generation format with excellent compression

Quick Start

Image Optimizer

  1. Add Images - Drag and drop images or folders into the input area, or click to browse
  2. Build Processing Chain - Drag desired processing steps from the palette to create your workflow
  3. Configure Steps - Click on each processing step to configure its settings (resize, quality, watermark, etc.)
  4. Choose Output - Select same folder as source or browse for custom directory
  5. Process - Click "Process Chain" and monitor real-time progress with time estimates
  6. View Results - Open the output folder to see processed images with summary

Image Combiner

  1. Add Files - Drag and drop images or PDF files into the combiner dropzone
  2. Choose Layout - Select vertical (stacked) or horizontal (side-by-side) alignment
  3. Set Dimensions - Configure maximum output size and spacing between images
  4. Select Format - Choose output format and quality settings
  5. Combine - Click "Combine Images" to create your merged image with progress tracking

Interface Overview

Navigation

  • Start Page - Welcome screen with quick access to main functions
  • Image Optimizer - Main processing interface with file input and settings
  • Image Combiner - Combine multiple images or PDF pages into single output
  • Help - Comprehensive documentation, keyboard shortcuts, and app information

Processing Chain Workflow

The optimizer uses a visual drag-and-drop interface for building processing workflows:

  • Step Palette - Available processing steps including resize, quality, format, filters, watermark, crop, rotate & flip, brightness, contrast, saturation, AI upscale, batch rename, and EXIF management
  • Chain Builder - Drag steps from palette to processing chain in desired order
  • Step Configuration - Click any step in the chain to configure its specific settings
  • Order Control - Reorder steps by dragging within the chain or remove with right-click
  • Visual Feedback - Each step shows its current configuration and status in the chain

Keyboard Shortcuts

The application supports universal keyboard shortcuts that work across all platforms and keyboard layouts:

  • 1-3 - Switch between main sections (Optimizer, Combiner, Help)
  • Ctrl/Cmd + Del - Clear all files
  • Ctrl/Cmd + Enter - Start processing
  • Ctrl/Cmd + O - Open output folder
  • Escape - Cancel processing

Advanced Configuration

Resize Modes

  • Fit - Maintain aspect ratio, image fits entirely within specified dimensions
  • Fill - Crop image to fit exact dimensions while maintaining aspect ratio (may crop)
  • Stretch - Stretch image to fill dimensions exactly (ignores aspect ratio, may distort)
  • Contain - Maintain aspect ratio, fit within dimensions with background fill

Image Enhancements

  • Adjustments - Brightness (-100 to +100), Contrast (-100 to +100), Saturation (-100 to +100)
  • Filters - Blur, sharpen, grayscale, sepia, vintage, noir, warm, and cool filters with adjustable intensity
  • Cropping - Preset aspect ratios (Square 1:1, Landscape 16:9, Portrait 9:16, Classic 4:3, Social 4:5) or custom dimensions with X/Y offset control
  • Rotation - Precise 90° increment rotation (0°, 90°, 180°, 270°) with horizontal and vertical flip options

Combination Options

  • Vertical Alignment - Stack images from top to bottom with customizable spacing
  • Horizontal Alignment - Place images side by side from left to right
  • Spacing Control - Adjust pixel spacing between combined images (0-100px)
  • Maximum Dimensions - Set output size limits with automatic intelligent scaling
  • Background Fill - Choose background color for empty areas with color picker

Watermark Configuration

  • Position - Center, top-left, top-right, bottom-left, bottom-right
  • Opacity - 0-100% transparency control with live preview
  • Size - 5-50% of image width with proportional scaling
  • Format Support - PNG with transparency recommended for best results

Batch Rename Patterns

The batch rename step in the processing chain supports flexible pattern-based renaming with these variables:

  • {original_name} - Original filename without extension
  • {counter} - Auto-incrementing number with configurable start and padding
  • {date} - Current date in YYYY-MM-DD format
  • {time} - Current time in HH-mm-ss format
  • {year} - Current year in YYYY format
  • {month} - Current month in MM format
  • {day} - Current day in DD format

Configuration Options:

  • Counter Start - Starting number for the counter (default: 1)
  • Counter Padding - Number of digits with zero-padding (default: 3)
  • Case Control - Convert filename to uppercase or lowercase
  • Preview in Processing Chain - See filename patterns when configuring the rename step

Examples:

  • {original_name}_{counter}image_001.jpg, image_002.jpg
  • IMG_{counter}_{date}IMG_001_2025-08-26.jpg
  • {date}_{time}_{original_name}2025-08-27_14-30-52_photo.jpg
  • batch_{counter} with start=10, padding=2 → batch_10.jpg, batch_11.jpg

Performance & Optimization

  • Lightning-Fast Processing - Powered by libvips for maximum performance
  • Memory Efficient - Optimized for processing large batches without memory issues
  • Multi-Threading - Utilizes all available CPU cores for fastest processing
  • Smart Time Estimation - Accurate progress tracking with remaining time calculation
  • Batch Optimization - Intelligent processing order for optimal performance

Technical Details

  • Built with - Electron framework for cross-platform compatibility
  • Image Processing - libvips and sharp.js for high-performance processing
  • PDF Processing - pdf-poppler for high-quality PDF page extraction
  • Languages - HTML5, CSS3, JavaScript (ES6+)
  • Supported OS - Windows 10/11, macOS 10.14+, Linux (Ubuntu 18.04+)
  • Architecture - Modern web technologies with native system integration
  • Security - Context isolation and secure design principles

System Requirements

Minimum Requirements

  • OS: Windows 10, macOS 10.14, or Linux (Ubuntu 18.04+)
  • RAM: 4GB RAM
  • Storage: 400MB available space
  • Display: 1024x768 resolution

Recommended Requirements

  • OS: Windows 11, macOS 12+, or modern Linux distribution
  • RAM: 8GB RAM or more for large batch processing
  • Storage: 1GB available space for temporary files
  • Display: 1920x1080 resolution or higher

Update History

27/08/2025 - 1.2.0 - Major feature update with modern image processing capabilities

  • Complete processing chain workflow system with drag-and-drop step building
  • AI image upscaling using Real-ESRGAN models for 2x and 4x enhancement integrated into processing steps
  • Enhanced watermarking system with text and image support, custom fonts, colors, and live preview
  • Advanced batch rename with flexible pattern system and variables
  • EXIF management for privacy and optimization
  • Improved image processing with enhanced resize modes, filters, and adjustments
  • Context menu integration for quick access to features
  • Enhanced keyboard shortcuts and user interface
  • Improved Electron security with context isolation

02/08/2025 - 1.1.0 - New Image Combiner tab for merging multiple images

  • PDF support with high-quality page extraction
  • Vertical and horizontal alignment options
  • Custom spacing and maximum dimension controls
  • Background color customization for combined images

25/07/2025 - 1.0.0 - Complete rewrite with modern UI

  • Multi-language support (English/German)
  • Advanced watermarking system
  • Pattern-based batch renaming
  • Auto-updater functionality
  • Comprehensive settings panel
  • Real-time progress tracking
  • Modern drag & drop interface

11/18/2020 - 0.0.2 - Updated dependencies + small bug fixes

04/16/2019 - 0.0.1 - Initial release

Credits

Developed by www.bavamont.com

Powered by:

  • libvips - High-performance image processing library
  • sharp.js - Fast Node.js image processing with comprehensive format support
  • pdf-poppler - High-quality PDF to image conversion
  • Electron - Cross-platform desktop application framework
  • UpscalerJS - AI image upscaling with Real-ESRGAN models
  • exifr - EXIF metadata reading and processing
  • TensorFlow.js - Machine learning framework for AI features