karabiner / Finder image transforms

Keep the original. Change the format.

Converters reads the current Finder selection, asks for an output format, routes each supported image through the available local engine, and writes converted copies beside untouched originals.

Run the batch replay Inspect engine routing

converters / Finder selection simulation ready

deterministic simulation

The rows below are synthetic. This page cannot read Finder, inspect files, run an image engine, or write output.

synthetic selection 4 files

output format

active enginewaiting

source	original	engine route	result
field-scan.heic	`HEIC / retained`	resolve on run	queued
relay-diagram.svg	`SVG / retained`	resolve on run	queued
review-proof.jpg	`JPG / retained`	resolve on run	queued
already-exported.png	`PNG / retained`	same-format guard	skip candidate

simulation.ready / 4 synthetic files / no Finder access

select → choose → route → report

A batch stays legible.

The general converter summarizes the Finder selection, offers eight output formats, chooses an engine per file, and distinguishes a complete run from a partial or empty one.

01 / selection

Read Finder once

The script asks Finder for the current selection and builds a compact prompt with the count and up to eight visible filenames.

02 / output

Choose one target

PNG, JPG, TIFF, GIF, BMP, WEBP, PDF, and HEIC are available from the menu. Cancelling exits without writing.

03 / route

Use the fitting engine

Supported raster work goes through sips; SVG prefers rsvg-convert for PNG; ImageMagick handles its required edges.

04 / preserve

Write beside, never over

Each converted copy uses the original basename and a new extension. A source already in the target format is skipped rather than clobbered.

native first / explicit fallbacks

The edge determines the engine.

There is no single pretend-universal converter. The scripts resolve built-in and Homebrew tools explicitly, then report when the selected edge cannot be completed.

sips / built in

Raster conversion

macOS handles supported PNG, JPEG, TIFF, GIF, BMP, and HEIC raster outputs without an additional package.

rsvg-convert

SVG to PNG

SVG input prefers librsvg for PNG rasterization. The dedicated SVG script uses a 2× scale by default for a sharper result.

ImageMagick

Coverage at the edges

WEBP and PDF output require ImageMagick. It also provides the fallback for SVG routes that rsvg-convert cannot serve.

Partial conversion is a first-class result.

Glass marks a complete batch, Basso reports no convertible match, and Purr marks a partial run. A notification says how many files converted instead of flattening every outcome into success.

notification / local receipt

five scripts / eight outputs

Use a direct edge or open the menu.

Four narrow scripts cover repeated conversions without a format prompt. The fifth is the general Finder menu used in the interactive replay above.

direct / HEIC

HEIC → JPG or PNG

Two dedicated scripts route common iPhone image exports through the built-in macOS conversion engine.

direct / JPG

JPG → PNG

A one-edge script removes the format menu when the desired output is already known.

direct / SVG

SVG → PNG

The vector path prefers librsvg, falls back to ImageMagick, and retains the SVG source beside its PNG copy.

general / menu

Selection → 8 formats

The menu converter handles mixed supported selections, picks the right engine per file, and summarizes the batch result.

Finder selection / local copies

A format change stays reversible.

The suggested general-menu trigger is Command + Shift + J. The repository installer fetches the five-script directory as one tool.

install

Fetch the converter suite

$./install.sh converters

The registered entrypoint is convert-menu-finder; the four direct scripts remain available in the installed directory.

full coverage

Install ImageMagick

$brew install imagemagick

ImageMagick is required for WEBP and PDF output and supplies SVG fallback coverage.

SVG preferred path

Install librsvg

$brew install librsvg

rsvg-convert is the preferred SVG-to-PNG engine; ImageMagick remains a supported fallback.

suggested trigger

Command + Shift + J

The real shortcut reads the current Finder selection. This webpage uses four named synthetic rows and cannot access Finder.

Request repository access Return to the registry