Transform your images for the web with AI-powered optimization 🎯
Achieve 96%+ compression while maintaining zero perceivable quality loss
🎯 Perfect for Web Developers, Designers & Content Creators
- Blazing Fast: Process hundreds of images in seconds
- AI-Powered: Intelligent content analysis for optimal compression
- Web-Ready: Automatic dimension constraints (1920×1080 max)
- Zero Quality Loss: Advanced algorithms preserve visual fidelity
- Batch Processing: Handle entire directories effortlessly
- Cross-Platform: Works on Windows, macOS, and Linux
- AI-powered content detection (photos vs graphics vs mixed)
- Dynamic quality optimization based on image characteristics
- Edge detection algorithms for preserving sharp details
- Color complexity analysis for optimal compression strategies
- Automatic resizing to fit 1920×1080 (Full HD) constraints
- Aspect ratio preservation - never distorts your images
- Smart scaling algorithms using Lanczos3 resampling
- Perfect for responsive web design
- Enhanced quality settings (88% photos, 85% graphics)
- Advanced sharpening to maintain perceived quality
- No compression artifacts - professional results guaranteed
- Content-aware optimization for different image types
- Parallel processing with configurable concurrency
- Memory-efficient streaming for large files
- Progress reporting with real-time feedback
- Error resilience - continues processing on individual failures
🎉 OPTIMIZATION RESULTS
═══════════════════════════════════════
📊 Original Images: 136 files
📁 Original Size: 593.36 MB
📁 Optimized Size: 23.27 MB
💾 Space Saved: 570.09 MB
📉 Compression: 96.1%
📐 Resized: 121 images to fit 1920×1080
✨ Zero perceivable quality loss!
# Install globally
npm install -g webp-image-optimizer
# Or use with npx (no installation required)
npx webp-image-optimizer# Optimize all images in current directory
webp-optimizer . ./optimized
# Optimize with custom quality
webp-optimizer ./photos ./web-ready --photo-quality 90
# Process with maximum concurrency
webp-optimizer ./images ./output -c 8
# Verbose output with progress
webp-optimizer ./photos ./optimized -vwebp-optimizer <source> [output] [options]
Arguments:
source Source directory with images to optimize
output Output directory (default: ./optimized)
Options:
-q, --quality <number> Default quality for all images (1-100)
--photo-quality <number> Quality for photographs (default: 88)
--graphic-quality <number> Quality for graphics/UI (default: 85)
--mixed-quality <number> Quality for mixed content (default: 86)
-c, --concurrency <number> Concurrent processing (default: 4)
--continue-on-error Continue if individual images fail
--no-progress Disable progress reporting
--no-report Skip generating optimization report
--report-format <format> Report format: json|text (default: json)
-v, --verbose Enable detailed output
-h, --help Display help information# Basic optimization
webp-optimizer ./my-photos ./web-photos
# High-quality photography portfolio
webp-optimizer ./portfolio ./web-portfolio --photo-quality 92
# UI/Graphics optimization
webp-optimizer ./ui-assets ./optimized --graphic-quality 90
# Batch process with custom settings
webp-optimizer ./images ./output \
--photo-quality 90 \
--graphic-quality 85 \
--concurrency 8 \
--verbose
# Generate text report
webp-optimizer ./photos ./optimized --report-format text- JPEG/JPG - Full support with EXIF handling
- PNG - Including transparency preservation
- DNG - RAW format with tone mapping
- TIFF - Professional image format
- WebP - Modern, efficient web format with superior compression
- E-commerce sites - Product image optimization
- Portfolio websites - High-quality image galleries
- Blog platforms - Fast-loading article images
- Landing pages - Hero images and backgrounds
- App assets - Icons, backgrounds, UI elements
- Content delivery - User-generated images
- Progressive web apps - Offline-ready images
- Social media - Platform-optimized images
- Digital marketing - Ad creatives and banners
- Photography - Web portfolio preparation
import { BatchProcessor } from 'webp-image-optimizer';
const processor = new BatchProcessor({
quality: {
photo: 90,
graphic: 85,
mixed: 87,
minimum: 75
},
dimensions: {
maxWidth: 1920,
maxHeight: 1080,
preserveAspectRatio: true
},
processing: {
concurrency: 6,
continueOnError: true
}
});
const report = await processor.processDirectory({
sourceDirectory: './images',
outputDirectory: './optimized'
});
console.log(`Processed ${report.successfulConversions} images`);
console.log(`Saved ${(report.totalSizeReduction / 1024 / 1024).toFixed(2)} MB`);import { DynamicQualityCalculator } from 'webp-image-optimizer';
const calculator = new DynamicQualityCalculator(80); // minimum quality
const result = await calculator.calculateOptimalQuality('./image.jpg');
console.log(`Optimal quality: ${result.quality}%`);
console.log(`Strategy: ${result.strategy}`);
console.log(`Reasoning: ${result.reasoning}`);| Image Count | Original Size | Optimized Size | Time Taken | Compression |
|---|---|---|---|---|
| 50 images | 245 MB | 12.3 MB | 45s | 95.0% |
| 100 images | 487 MB | 23.1 MB | 78s | 95.3% |
| 500 images | 2.1 GB | 98.7 MB | 4m 12s | 95.3% |
| 1000 images | 4.3 GB | 201 MB | 8m 45s | 95.3% |
Benchmarks run on MacBook Pro M1 with 16GB RAM
Original JPEG (4032×3024, 2.1MB) → WebP (1440×1080, 89KB)
✅ 95.8% size reduction
✅ Maintains visual quality
✅ Web-optimized dimensions
✅ Faster loading times
- SSIM Score: >0.95 (Structural Similarity)
- Color Accuracy: >90% retention
- Edge Preservation: >85% sharpness retention
- Compression Artifacts: None perceivable
- Graceful degradation - Continues processing on individual failures
- Memory management - Handles large image batches efficiently
- File validation - Checks image integrity before processing
- Detailed logging - Comprehensive error reporting
- Recovery options - Retry mechanisms for transient failures
- Node.js 16.0 or higher
- Memory: 4GB RAM recommended for large batches
- Storage: Sufficient space for output images
- Platforms: Windows, macOS, Linux
We welcome contributions! Here's how you can help:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit changes:
git commit -m 'Add amazing feature' - Push to branch:
git push origin feature/amazing-feature - Open a Pull Request
# Clone the repository
git clone https://github.com/yourusername/webp-image-optimizer.git
cd webp-image-optimizer
# Install dependencies
npm install
# Build the project
npm run build
# Run tests
npm test
# Run integration tests
npm run test:integrationThis project is licensed under the MIT License - see the LICENSE file for details.
- Sharp - High-performance image processing library
- WebP - Modern image format by Google
- TypeScript - Type-safe JavaScript development
- Commander.js - Command-line interface framework
- 🐛 Bug Reports: GitHub Issues
- 💡 Feature Requests: GitHub Discussions
- 📧 Email: support@webp-optimizer.com
- 💬 Discord: Join our community
webp image-optimization batch-processing web-development compression typescript nodejs cli-tool image-converter performance ai-powered content-optimization responsive-images web-performance seo-optimization
⭐ Star this repository if it helped you optimize your images! ⭐
🚀 Get Started • 📖 Documentation • 🐛 Report Bug • 💡 Request Feature