rawctl

rawctl es la herramienta de desarrollo de Frames para importar, inspeccionar y renderizar fotos y resolver problemas desde la línea de comandos.

Para scripts de flujos compatibles, consulta Automatización de flujos de trabajo.

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 versiones 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>