timothy ali
+0000Denver, CO39.7392N 104.9903W--:--:--SYS.OK
Toolbox [04] / Images in, new formats and smaller files out

Convert

Change image formats, resize images, and adjust compression.

In
PNG, JPEG, WebP, GIF, BMP, ICO, AVIF, SVG; HEIC, TIFF, PSD on macOS
Out
PNG, JPEG, WebP, TIFF, PDF
Toolbox in the Convert tool: two posters listed with their measured output sizes per format, and format, compression and edge controls in the right rail.

When to use it

Prepare images for the web, change their format, or limit their dimensions. Convert reads PNG, JPEG, WebP, GIF, BMP, ICO, AVIF, and SVG on both platforms. HEIC, TIFF, and PSD input is supported on macOS only. Use Lockup when you need a full set of logo variations.

Exported files

One file for each source image in each selected format. When you choose multiple formats, Toolbox puts them in separate folders, such as PNG and WebP.

  • PNG
  • JPEG
  • WebP
  • TIFF
  • PDF

CLI & MCP

Run this example in a terminal after setting up the toolbox command. Replace the sample inputs with your own. The CLI and MCP use the app’s export engine with the options listed below.

toolbox convert a.heic b.png --formats webp --compression 40 --out ~/Desktop
--action <export|inspect|preview|library-list|library-get|library-remove>
Export files, inspect settings and the output plan without writing, render previews, or manage saved work. Convert previews write the selected output formats; other tools write PNG. Specimen also lists fonts. Default: export.
--saved <value>
Saved-work ID to reopen. Explicit options override its settings. Required for library-get and library-remove.
--save
Save the completed export to the app library, or update the reopened record. Defaults to false for scripts. Default: false.
--input <values…>
Paths of the image files to convert. You can supply these values without --input. Required unless reopening saved work or querying the library.
--formats <png|jpeg|webp|tiff|pdf>
Output formats. Every input is written in each one. Default: png.
--compression <number>
How hard to compress, 0 to 100. 0 uses the highest encoder quality; conversion still re-encodes the image. 100 applies the strongest compression offered. Applies to JPEG, WebP and PDF; PNG and TIFF are lossless and ignore it. Default: 10.
--originalSize
Clear a saved resize limit and keep original dimensions. Cannot be combined with longestEdge. Default: false.
--longestEdge <number>
Cap the longest side, in pixels, keeping the aspect ratio. Omit to keep each image at its own size. Images already smaller are left alone.
--background <value>
Fill behind transparency: 'none' keeps it wherever the format allows, or give a hex colour like '#ffffff'. JPEG and PDF have no transparency and fill with white when this is 'none'. Default: none.
--out <value>
Folder to write into. A fresh subfolder is created inside it, so nothing is overwritten. Required for export and preview.
CLI & MCP setup
Next / [01]Lockup
(C) 2026 Timothy Ali // A little human. A little machine. // EOF