cwebpb - Batch WebP Converter Plugin for Oh-My-Zsh

July 22, 2025 · View on GitHub

A convenient Oh-My-Zsh plugin that converts common image formats (JPG, PNG, GIF, BMP, TIFF) to WebP format using Google's cwebp tool in batch mode.

Features

  • 🖼️ Converts multiple image formats to WebP
  • 📁 Process entire directories or current directory
  • ⚙️ Flexible cwebp options support
  • 🔒 Safe: skips existing WebP files to avoid overwriting
  • 📊 Progress reporting with conversion summary
  • 🎯 Case-insensitive file extension matching
  • ✨ Clean, colorful output with status indicators

Prerequisites

You need to have cwebp installed on your system:

macOS:

brew install webp

Ubuntu/Debian:

sudo apt install webp

Arch Linux:

sudo pacman -S libwebp

Windows (WSL):

sudo apt install webp

Installation

Method 1: Using Oh-My-Zsh custom plugins

  1. Clone this repository into your custom plugins directory:
git clone https://github.com/adi-li/zsh-cwebpb.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-cwebpb
  1. Add the plugin to your ~/.zshrc file:
plugins=(... zsh-cwebpb)
  1. Restart your terminal or run:
source ~/.zshrc

Method 2: Using Antigen

Add this line to your ~/.zshrc:

antigen bundle adi-li/zsh-cwebpb

Method 3: Using Zinit

Add this line to your ~/.zshrc:

zinit load "adi-li/zsh-cwebpb"

Usage

Basic Usage

# Convert all images in current directory (default quality: 85)
cwebpb

# Convert images in specific directory
cwebpb /path/to/images

# Convert with custom quality
cwebpb -- -q 90

# Convert specific directory with custom quality
cwebpb /path/to/images -- -q 90

Advanced Usage

# High quality conversion
cwebpb -- -q 95 -m 6

# Lossless conversion
cwebpb -- -lossless

# Low quality for smaller files
cwebpb -- -q 60

# Multiple options
cwebpb /path/to/images -- -q 80 -alpha_q 85 -m 4

Supported Image Formats

  • JPEG/JPG
  • PNG
  • GIF
  • BMP
  • TIFF/TIF

All file extensions are matched case-insensitively (e.g., .JPG, .png, .GiF all work).

Output Example

🖼️  Converting images in: ./photos
⚙️  Using cwebp options: -q 85

✓ Converted: IMG_001.jpg → IMG_001.webp
✓ Converted: photo.PNG → photo.webp
⚠ Skipped (already exists): existing.webp
✗ Failed to convert: corrupted.gif

📊 Summary: 2 converted, 1 skipped, 1 failed

Commands

  • cwebpb - Batch WebP conversion function (cwebp batch)

License

MIT License - feel free to use and modify as needed.

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Issues

If you encounter any problems or have suggestions, please open an issue on GitHub.