KonvertImg

A CLI tool for converting images to WebP format with interactive quality presets.

Why this CLI?

FFmpeg is a powerful and fantastic tool, but converting a simple image can feel overwhelming with its thousands of parameters. KonvertImg was created for those moments when you just need to:

• Quickly convert heavy images to optimized WebP format
• Keep your privacy by converting locally instead of uploading to online services
• Skip the complexity of memorizing FFmpeg parameters for common tasks

No expertise required—just a simple, interactive CLI for everyday image conversion needs.

Requirements

FFmpeg must be installed:

brew install ffmpeg           # macOS
sudo apt install ffmpeg       # Ubuntu/Debian

Verify: ffmpeg -version

Installation

npx konvertimg              # Run directly (no install)
npm install -g konvertimg   # Or install globally

Usage

Simply run konvertimg and follow the interactive prompts:

1. Select your image file
2. Choose quality preset (with size estimates)
3. Confirm output path
4. Done!

Features

• Interactive CLI with quality presets (low/medium/high)
• Auto-resize to 1920px width (maintains aspect ratio)
• Real-time size estimation before conversion
• Compression statistics after conversion
• Supports JPEG, PNG, BMP, TIFF, GIF

Quality Presets

| Preset | Quality | Best For | |--------|---------|----------| | Low | 30 | Thumbnails, previews | | Medium | 50 | General web use, social media | | High | 70 | Portfolios, high-quality images |

Example

$ konvertimg
✓ FFmpeg available
? Path to image: photo.jpg
  Original size: 2.4 MB
? Choose quality: Medium (~420 KB)
? Output path: photo_web.webp
✓ Conversion successful!
  Final size: 420 KB (82.5% compression)

License

MIT