Fassungen importieren — Dateiformat

Fassungen importieren ist ein Wiederherstellungs-Tool für Support-Fälle — zum Beispiel, um eine Fassungsbibliothek nach einem Geräteverlust wiederherzustellen, wenn kein iCloud-Backup existiert. Standardmäßig ist es ausgeblendet: Der Eintrag erscheint unter Einstellungen → Backup erst, wenn der Frame-Support ihn für deinen Account freischaltet. Wenn du denkst, dass du es brauchst, schreib uns zuerst an [email protected].

Ordnerstruktur

Der Importer bittet dich, einen Ordner auszuwählen, der eine Manifest-Datei und die darin referenzierten Fotos enthält:

My Frames/
├── frames.json
├── rayban-aviator.jpg
├── rayban-aviator-sticker.jpg
└── persol-649.jpg

Fotos können auch in einem verschachtelten Unterordner liegen — der Importer löst reine Dateinamen eine Ebene tief auf.

frames.json

{
  "version": 1,
  "frames": [
    {
      "client_id": "5D2A7C1E-4B9F-4E2A-8C3D-1F6E9A0B2C4D",
      "name": "Ray-Ban Aviator",
      "image": "rayban-aviator.jpg",
      "sticker_image": "rayban-aviator-sticker.jpg",
      "brand": "Ray-Ban",
      "model": "RB3025",
      "shape": "aviator",
      "is_favorite": true,
      "price_amount": 161.0,
      "price_currency": "USD",
      "product_url": "https://example.com/rb3025",
      "created_at": "2026-05-01T10:00:00Z"
    },
    {
      "client_id": "0A1B2C3D-4E5F-6789-ABCD-EF0123456789",
      "name": "Persol 649",
      "image": "persol-649.jpg"
    }
  ]
}

Felder

Feld	Erforderlich	Hinweise
client_id	ja	UUID-String. Duplikate von Fassungen, die bereits auf dem Gerät liegen, werden übersprungen, nie überschrieben.
name	ja	Anzeigename der Fassung.
image	empfohlen	Relativer Pfad zum Hauptproduktfoto (JPEG/PNG). Eine fehlende Datei ist unkritisch — die Fassung wird ohne Foto importiert.
sticker_image, additional_image_1, additional_image_2	nein	Zusätzliche Fotos, gleiche Pfadregeln wie bei image.
brand, model, shape, size, material, color_variant	nein	Freie Textwerte.
lens_width, bridge_width, temple_length	nein	Millimeter, Zahlen.
is_favorite	nein	Boolean, Standard ist false.
price_amount, price_currency, original_price_amount, product_url	nein	Preis-Metadaten.
created_at	nein	ISO 8601-Zeitstempel; Standard ist der Importzeitpunkt.

So verhält sich der Import

• Streng additiv: Vorhandene Fassungen werden nie verändert oder gelöscht.
• Die Deduplizierung erfolgt über client_id — derselbe Import kann gefahrlos wiederholt werden.
• Importierte Fassungen werden mit deinem Account und dem iCloud-Backup synchronisiert wie normal hinzugefügte Fassungen.