rawctl

rawctl ist das Entwicklungswerkzeug von Frames zum Importieren, Untersuchen und Rendern von Fotos sowie zur Fehlersuche über die Befehlszeile.

Für unterstützte Workflow-Skripte siehe Workflow-Automatisierung.

Die Befehle verwenden denselben Katalog wie die App. Die Tabelle nennt insbesondere Downloads und Schreibzugriffe.

Befehl	Funktion
import <folder>	Einen Bildordner importieren
list [limit] [--tagged <name>]	Katalogisierte Fotos auflisten, neueste zuerst; --tagged begrenzt auf einen Begriff aus dem Analyseindex
stats	Katalog- und Cache-Statistiken
photos [--album T] [--limit N]	Aus Apple Fotos importieren, begrenzt nach Album oder Anzahl
collections	Sammlungsbaum ausgeben
sync-collections	Sammlungsbaum und Zuordnungen neu schreiben
sync [--force] [--render N]	Änderungen synchronisieren und bis zu N ausstehende Vorschauen rendern; Standard 500, 0 überspringt das Rendern
backfill [n]	Aufnahmemetadaten für n Fotos ergänzen; lädt Originale herunter
recipe <assetId>	Rezepte aller Versionen als JSON ausgeben und die ausgewählte kennzeichnen
previews [limit]	Höher aufgelöste Vorschauen für Fotos unterhalb der Zielauflösung aus iCloud laden; fortsetzbar
reproxy [limit]	Vorschauen aus bereits lokal vorhandenen Originalen neu erstellen; keine Downloads, Einträge ohne lokales Original werden übersprungen; Standardlimit 200
repair-filenames [--apply] [limit]	Fotos-Einträge korrigieren, deren gespeicherter Name nicht zur von Frames dekodierten Ressource gehört; liest nur lokale Metadaten, keine Downloads; ohne --apply nur Bericht, keine Änderungen
repair-capture-dates [--apply] [limit]	Vollständige Fotos-Einträge korrigieren, deren Aufnahmedatum von Apple Fotos abweicht; liest nur lokale Metadaten, keine Downloads; ohne --apply nur Bericht, keine Änderungen
analyse [--limit N] [--collection ID]	Fotos mit Vision anhand lokaler Vorschauen analysieren; keine Downloads, Einträge ohne lokale Vorschau werden übersprungen; Standardlimit 200
sweep [--limit N] [--collection ID]	Ausstehende Fotos jeweils zu viert anhand lokaler Vorschauen analysieren; nennt vorher den Aufwand und lädt nichts herunter; Standardlimit 200
rederive	Erkannte Begriffe nach einer Änderung des Vokabulars aus gespeicherten Messwerten neu ableiten, ohne Vision erneut auszuführen
tags [--limit N]	Erkannte Begriffe nach Gruppe auflisten, häufigste zuerst
search <query>	Bildinhalte suchen; ohne Analyseindex nur Dateiname und Kamera
similar <filename> [--limit N]	Visuell ähnliche Fotos auflisten, ähnlichste zuerst; Standardlimit 10
sets preview [--collection ID] [--gap S] [--split D]	Automatische Gruppierung ohne Änderungen voranzeigen; --gap bestimmt die zeitliche Aufnahmelücke, die eine Serie beendet, --split den Abstand der Bildmerkmale, der sie teilt; liest Katalog und Analyseindex, keine Downloads
sets apply [--collection ID] [--limit N]	Automatische Gruppierung anwenden und Änderungen melden; schreibt Gruppenzuordnungen; Standardlimit 5000
render <assetId> --out <file.jpg>	Rezept in voller Auflösung rendern; nur Fotos aus dem Dateisystem
export --out <dir> --rating <n> [--limit N]	Bewertete Fotos in ein Verzeichnis exportieren; --rating ist erforderlich, --limit beträgt standardmäßig 200; fehlende Originale werden heruntergeladen. Weitere Optionen: --format jpeg|heif|tiff16|png8|png16, --long-edge N, --folder <template> und --name <template>