The field guide / Version 1.2

A little know-how.
A better workflow.

From your first image to your next hundred. Everything you need to make the app your own.

Quick start

Add images or folders using Browse Files, drag and drop, or Command-O. Folder imports include top-level files by default; enable Include all subfolders when you need the full tree.

Choose WebP, JPG or PNG, maximum dimensions and quality. Select an image to see its live preview, then choose Beside originals or an Output folder and click Process Images.

Install or update

Download the latest DMG, open it, and drag The Transmogrifier into Applications. Quit an older installed copy before replacing it. Your saved presets and history are retained.

The direct-download app is signed with Developer ID and notarized by Apple. It supports Intel and Apple Silicon Macs running macOS 12 Monterey or later.

Dimensions and destinations

Max width and Max height are caps. Leave a field empty for Auto. Images preserve their proportions and orientation, and smaller images are never enlarged. These settings fit an image within a box; they do not crop it to a square.

Beside originals saves into each source folder. Output folder requires an explicit destination. Choose a folder with Browse to grant macOS access, then save your preset to remember it. If a folder moves or permission expires, choose it again.

Advanced contains DPI, Rename/Skip/Overwrite collision rules and source-folder preservation. Originals are protected from being overwritten by their own conversions.

Supported formats

Import JPG, PNG, WebP, HEIC, TIFF, BMP, GIF, ICNS and ICO. Export WebP, JPG or PNG. The app prepares still images; animated exports are not supported.

WebP supports transparency and lossy compression. JPG is suitable for photographs and does not support transparency. PNG is lossless.

Quality and file-size limits

Quality directly controls the encoder: higher values generally produce larger, higher-quality files. New settings start at 80%. Existing saved presets retain their previous encoder quality. PNG shows lossless status instead of a quality slider.

Enable Keep each image under a file-size limit and enter a budget in KB. One KB is 1,000 bytes. Choose a minimum quality at or below your selected quality. The app searches within that range while respecting your dimension caps.

If the target is unreachable, that output is reported without writing a file. Reduce dimensions, lower the minimum quality or raise the limit. PNG checks its lossless result against the budget. For responsive packs, the budget applies to every output separately.

Responsive packs

Enable Create a responsive image pack and enter up to eight comma-separated widths, such as 640, 1280, 1920. Packs export WebP, with optional JPG fallbacks for each width.

Use a filename template containing both {name} and {width}, for example {name}-{width}. Widths reflect actual output dimensions. Small originals and dimension caps can reduce them; duplicate capped sizes are exported once.

After export, Copy srcset in History gives a separate block for each original and format. The values use exported filenames and actual widths. Add the appropriate website path when placing them into your markup.

Preview and compare

Preview updates automatically when the selected image or relevant settings change. File sizes describe the actual encoded result. For a responsive pack, the preview shows the largest WebP variant.

Choose Compare to inspect the original and export with a wipe, shared zoom and scrolling. Use 100% for pixel inspection or Fit to see the whole image. Checkerboard, white and black backgrounds help inspect transparency. Shift-Command-R refreshes the preview.

Presets and Dock quick conversion

Choose Save to store your format, quality, dimensions, output options and destination as a preset. Saving under an existing custom preset name updates it in place.

For automatic conversion, choose a saved preset under Advanced → Dock quick convert. Opening images with the app in Finder or dropping files or folders onto its Dock icon then uses that recipe, including its destination and collision rules. Open for review is the default and starts no export automatically.

History and recovery

History groups outputs into searchable jobs. Reveal outputs opens them in Finder. Reuse settings loads a recipe, Run again repeats the job, and Retry unfinished processes only unsuccessful or cancelled variants.

Pause and resume while a batch runs. Cancel retains completed outputs and records unfinished work for retry. If source files have moved or become inaccessible, add them or their folders again.

Earlier conversions preserves older history. Old records lack saved settings, so rerun is unavailable for those entries. Clear history removes records only, after confirmation; it does not delete original images or exported files.

Keyboard shortcuts

Command-O: add images. Command-Return: process images. Shift-Command-R: refresh preview. Command-?: open Help.

Troubleshooting

Cannot meet the file-size limit: increase the budget, reduce dimensions or lower the quality floor. No oversized fallback file is written.

Output folder needs access: use Browse to choose it again and save the preset. Beside-originals exports may ask you to grant access to the source folders.

A history storage error preserves the existing history file. Keep a backup before clearing damaged history. For other issues, include your macOS version, input format and relevant export settings in a GitHub issue.

Frequently asked questions

Do images leave my Mac? No. Image conversion happens locally and does not require an internet connection.

Will social presets crop to an exact square? No. Maximum dimensions preserve aspect ratio. Crop the original first if your delivery requires a specific shape.

Are AVIF, watch folders and CLI available? These remain future candidates. Version 1.2 focuses on repeatable image export workflows.

Still need a hand?