Skip to content

FlorianBx/konvertImg

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

Light CLI tool for converting images to WebP format with quality presets

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published