Este artículo actualmente solo está disponible en inglés.

CLIOct 7, 20255 min read

CLI Image Conversion for Designers Who Do Not Live in Terminal

Designers do not need to become command-line specialists to benefit from a CLI image converter. The value is not the terminal itself. The value is repeatability: the same folder, same output location, same quality decision, and same rule that originals stay untouched.

A good CLI workflow can be easier to trust than a series of manual exports because it reduces hidden clicks. Once the command is written down, anyone on the team can repeat it. The workflow still needs evidence: a preview command, a conversion command, a small visual review set, and a record of what actually ran. Without those details, "CLI for designers" becomes generic productivity advice instead of a usable production process.

Start With a Folder You Understand#

Do not point a command at your entire desktop. Create a small project folder:

launch-assets/
  originals/
  optimized/

Put only approved source images in originals. Keep drafts, design files, and rejected exports somewhere else. This first step is the difference between a controlled workflow and an accidental bulk mess.

Use One Simple Command#

For a basic WebP conversion with GetWebP CLI, keep the command readable, but preview before writing:

getwebp ./launch-assets/originals --dry-run

If the preview lists only approved files, run the conversion:

getwebp ./launch-assets/originals -o ./launch-assets/optimized --quality 82

This says: read top-level images from the originals folder, write converted files to the optimized folder, and use a fixed quality setting of 82. The original files are not modified.

If originals has subfolders, make that explicit in both commands:

getwebp ./launch-assets/originals --recursive --dry-run

getwebp ./launch-assets/originals \
  --recursive \
  -o ./launch-assets/optimized \
  --quality 82

The exact quality value should be decided by review, not copied from a random tutorial. For WebP output, omitting --quality lets GetWebP use auto-quality; passing --quality 82 makes the run fixed at that value. Start with a small set of representative images and adjust if text, product texture, faces, or transparent edges suffer.

Run Five Images Before the Full Folder#

Design teams usually spot problems faster with a tiny sample. Before converting a full campaign folder, copy five representative files into a test folder:

  • one hero photo
  • one product or portfolio image
  • one screenshot
  • one transparent asset
  • one small card or thumbnail

Run the command on that sample and review the outputs in context. If the settings pass, use the same command on the larger folder. If the sample fails, the team has only a few files to inspect instead of a confusing output set with dozens of questionable images.

This is also where format decisions belong. WebP is usually the safe default for website images; AVIF can be smaller, but --format avif uses fixed quality behavior and should be tested in the exact upload, CMS, or browser context where the assets will appear.

Keep a Command Note#

Design teams should not rely on shell history. Put the approved command in a note file inside the project:

Command:
getwebp ./originals --dry-run
getwebp ./originals -o ./optimized --quality 82

Use for:
Landing page photos and product cards.

Review:
Check hero image, product detail, and mobile card crop before upload.

This turns the CLI step into team knowledge. A teammate can repeat the export later without asking which settings were used.

For larger handoffs, keep a machine-readable result file too:

getwebp ./originals \
  -o ./optimized \
  --quality 82 \
  --json > ./conversion-report.ndjson

The report shows whether the run completed, which files succeeded, which failed, and where each output was written. It is more reliable than a screenshot of a terminal window.

Review Outputs Like Design Work#

Treat converted images as design deliverables. Open them in the actual page or prototype context and inspect:

  • faces and skin tones
  • product texture
  • brand colors
  • UI text in screenshots
  • transparent edges
  • gradients and shadows
  • mobile crops

Do not approve from file size alone. A smaller image that damages the campaign hero or product card is a failed export.

Use Clear Naming#

The CLI can only keep things organized if the folder starts organized. Use source filenames that describe the asset:

homepage-hero.jpg
pricing-dashboard.png
product-card-blue-chair.jpg

Avoid names like export-final-2.png in approved source folders. If the source names are messy, clean them before conversion so the WebP outputs are easier to identify.

If you use one shared output directory for a recursive run, repeated basenames can collide. For example, team/hero.jpg and product/hero.png both target hero.webp in a flat output directory. Split those folders into separate runs or separate output directories before asking a designer to approve the results.

Know the Few Commands That Matter#

Designers usually need only a small command vocabulary:

  • preview a folder without writing files
  • run a conversion after preview
  • choose an output folder
  • set quality
  • check the tool version
  • repeat the command after replacing source files

For GetWebP CLI, getwebp [path] is the core pattern, --dry-run previews the candidate input set, and -o sets an output directory. Use getwebp --help when you need to confirm available options in your installed version. The GetWebP CLI command reference documents the flags used here, and the JSON output guide explains the NDJSON report format.

Google's WebP documentation explains the format, and MDN's image file type guide gives context for choosing formats.

Avoid Terminal Anxiety by Making It Boring#

The command line feels risky when every run is improvised. Make it boring:

  1. Use a prepared folder.
  2. Run the saved command.
  3. Review the output folder.
  4. Upload only approved files.
  5. Keep originals untouched.

That process is often less error-prone than manually exporting dozens of files one by one.

The point of CLI image conversion for designers is not speed at any cost. It is a repeatable bridge between design assets and production-ready web images, with enough structure to protect quality and source files.

Jack avatar

Jack

GetWebP Editor

Jack writes GetWebP guides about local-first image conversion, WebP workflows, browser compatibility, and practical performance checks for teams that publish images on the web.