rawctl

rawctl permite importar, examinar, renderizar y diagnosticar fotos desde la línea de comandos.

Los comandos usan el mismo catálogo que la aplicación. La tabla indica su comportamiento, incluidas descargas y escrituras.

Comando	Función
import <folder>	Importar una carpeta de imágenes
list [limit] [--tagged <name>]	Listar fotos catalogadas, las más recientes primero; --tagged limita a una etiqueta del índice de análisis
stats	Estadísticas del catálogo y de las cachés
photos [--album T] [--limit N]	Importar desde Fotos de Apple, limitado por álbum o cantidad
collections	Mostrar el árbol de colecciones
sync-collections	Reescribir el árbol de colecciones y sus pertenencias
sync [--force] [--render N]	Sincronizar cambios y renderizar hasta N vistas previas pendientes; 500 por defecto, 0 omite el renderizado
backfill [n]	Completar metadatos de captura de n fotos; descarga originales
recipe <assetId>	Mostrar las recetas de todas las ediciones en JSON e identificar la seleccionada
previews [limit]	Descargar de iCloud vistas previas de mayor resolución para fotos por debajo del objetivo; se puede reanudar
reproxy [limit]	Regenerar vistas previas desde originales ya presentes en disco; no descarga y omite registros sin original local; límite inicial 200
repair-filenames [--apply] [limit]	Corregir registros de Fotos cuyo nombre guardado no coincide con el recurso que Frames decodifica; solo lee metadatos locales, sin descargas; sin --apply informa sin modificar
repair-capture-dates [--apply] [limit]	Corregir registros completos de Fotos cuya fecha de captura difiere de la de Fotos de Apple; solo lee metadatos locales, sin descargas; sin --apply informa sin modificar
analyse [--limit N] [--collection ID]	Analizar fotos con Vision a partir de vistas previas locales; no descarga y omite registros sin vista previa local; límite inicial 200
sweep [--limit N] [--collection ID]	Analizar las fotos pendientes de cuatro en cuatro desde vistas previas locales; indica antes el coste y no descarga; límite inicial 200
rederive	Regenerar términos detectados desde las mediciones guardadas tras cambiar el vocabulario, sin ejecutar Vision de nuevo
tags [--limit N]	Listar términos detectados por grupo, los más frecuentes primero
search <query>	Buscar contenido de fotos; sin índice de análisis solo busca nombre de archivo y cámara
similar <filename> [--limit N]	Listar fotos visualmente similares, las más próximas primero; límite inicial 10
sets preview [--collection ID] [--gap S] [--split D]	Previsualizar agrupaciones automáticas sin modificar pertenencias; --gap define el intervalo entre tomas que cierra una serie y --split la distancia entre descriptores visuales que la divide; lee catálogo e índice, sin descargas
sets apply [--collection ID] [--limit N]	Aplicar agrupación automática e informar de cambios; modifica pertenencias; límite inicial 5000
render <assetId> --out <file.jpg>	Renderizar una receta a resolución completa; solo fotos del sistema de archivos
export --out <dir> --rating <n> [--limit N]	Exportar fotos valoradas a un directorio; --rating es obligatorio y --limit vale 200 por defecto; descarga los originales que falten. También admite --format jpeg|heif|tiff16|png8|png16, --long-edge N, --folder <template> y --name <template>