rawctl

Use rawctl to import, inspect, render and troubleshoot photographs from the command line.

Commands use the same catalogue as the application. Review download and write behaviour in the table before running them.

Command	Does
import <folder>	Import a folder of images
list [limit] [--tagged <name>]	List catalogued photographs, newest first; --tagged narrows to one tag from the analysis index
stats	Catalogue and cache statistics
photos [--album T] [--limit N]	Import from Apple Photos, scoped by album or count
collections	Print the collection tree
sync-collections	Rewrite the collection tree and its membership
sync [--force] [--render N]	Sync changes and render up to N pending proxies (default 500, 0 to skip)
backfill [n]	Fill capture metadata for n photographs. Downloads originals
recipe <assetId>	Print recipe JSON for every treatment and identify the selected one
previews [limit]	Download higher-resolution previews from iCloud for photographs still below target; resumable
reproxy [limit]	Remake proxies from originals already on disk. Never downloads, and skips rows with no local original. Default limit 200
repair-filenames [--apply] [limit]	Rewrite Photos rows whose stored name is not the resource Frames decodes. Reads local metadata only and never downloads. Reports without writing unless --apply is passed
repair-capture-dates [--apply] [limit]	Rewrite complete Photos rows whose capture date disagrees with the one Photos holds. Reads local metadata only and never downloads. Reports without writing unless --apply is passed
analyse [--limit N] [--collection ID]	Analyse photographs with Vision, off proxies already on disk. Never downloads, and skips rows with no local proxy. Default limit 200
sweep [--limit N] [--collection ID]	Analyse the backlog four frames at a time, stating the cost first. Off proxies already on disk, and never downloads. Default limit 200
rederive	Rebuild detected words from stored measurements after a vocabulary change without rerunning Vision
tags [--limit N]	List detected words by group, most common first
search <query>	Search photograph content. With no analysis index it matches filename and camera alone
similar <filename> [--limit N]	List visually similar photographs, closest first. Default limit 10
sets preview [--collection ID] [--gap S] [--split D]	Preview automatic grouping without changing membership. --gap is the capture-time gap that closes a run, --split the feature-print distance that cuts one. Reads the catalogue and the analysis index, and never downloads
sets apply [--collection ID] [--limit N]	Apply automatic grouping and report changes. Writes membership. Default limit 5000
render <assetId> --out <file.jpg>	Render a recipe at full resolution. Filesystem assets only
export --out <dir> --rating <n> [--limit N]	Export a rated set to a directory. --rating is required, --limit defaults to 200, and it downloads every original it does not already hold. Also takes --format jpeg|heif|tiff16|png8|png16, --long-edge N, --folder <template> and --name <template>