Dateiformate

Alles, was ein Gerät weiß, ist ein nur wachsendes Protokoll von Einträgen plus die Fotos. Die Dateien unten tragen es zwischen Geräten oder halten es sicher; keine davon erreicht einen Server.

Das Bündel: `.catsync`#

Ein Zip mit jedem Eintrag, den der Absender hält, einer pro Zeile als JSON Lines, und den gerade benutzten Fotos unter ihrer Prüfsumme. Der Import läuft mit demselben Motor wie jeder andere Transport: Neues wird genommen, Bekanntes übersprungen, und der Versionsvektor des Bündels unterscheidet Konflikte. Private Werte sind nur drin, wenn der Schalter des Absenders es sagte. Ein Telefon und der Schreibtisch lesen einander die Bündel.

Der gemeinsame Ordner: `catlog-sync/`#

Jedes Gerät schreibt seine eigene Historie als Folge von Segmenten, <Gerät>.1.seg, .2.seg und so weiter, jedes eine JSON-Lines-Datei mit Einträgen, und ein Manifest, <Gerät>.manifest, mit seinem Versionsvektor und der Liste der Segmente. Ein volles Segment ändert sich nie wieder, darum bewegt ein Cloud-Client nur das offene. Fotos liegen in blobs/ unter ihrer Prüfsumme, die Signierschlüssel in keys/. Ein Ordner trägt mehrere Kataloge, jeden in einem eigenen Unterordner. Die Dateien jedes anderen Geräts werden nur gelesen.

Sicherungen#

Eine vollständige Kopie eines Katalogs, mit Fotos, als Bündel: auf dem Telefon im Ordner catlog-backups, den du freigegeben hast, auf dem Schreibtisch in deinem Downloads-Ordner, geschrieben, wenn die App nach Änderungen verlassen wird. Wiederherstellen liest sie als neue Kataloge.

Die Archivdatei und die Zurückgehen-Datei#

Archivieren schreibt die archivierten Katzen und Zuhause mit ihren Fotos in ein Bündel, bevor es sie löscht; der Import holt sie zurück. Zurückgehen zu einem Moment schreibt alles nach dem Moment in ein Bündel am selben Ort, bevor es entfernt wird.

Was nie mitreist#

Die Ortsangaben der Kamera, aus jedem gespeicherten Foto entfernt. Private Werte ohne den Schalter. Verstecktes und Gesperrtes gilt je Gerät und verlässt es nie.