Obsidian Sync unterstützt jetzt Headless-Clients

• Obsidian Sync bietet nun einen Headless-Client, mit dem sich in der Kommandozeilenumgebung synchronisieren lässt – ganz ohne Desktop-App
• Damit ist die Vault-Synchronisierung in nicht-interaktiven Umgebungen wie CI-Pipelines, Servern und Automatisierungsskripten möglich
• Mit dem Befehl ob sync lässt sich eine einmalige oder fortlaufende Synchronisierung ausführen; über die Umgebungsvariable OBSIDIAN_AUTH_TOKEN wird automatische Authentifizierung unterstützt
• Enthalten ist ein umfangreicher Befehlssatz für das Erstellen entfernter Vaults, das Einrichten lokaler Verknüpfungen, die Statusabfrage, das Ändern von Einstellungen und mehr
• Unter Windows und macOS steht ein nativer Modulbaustein zur Verfügung, der beim Erstellen von Dateien die Erstellungszeit (birthtime) beibehält und so die Datenintegrität verbessert

---

Überblick

• Der Headless Client von Obsidian Sync ist ein Werkzeug zum Synchronisieren von Vaults ohne Desktop-App
  • Nützlich in CI-, Automatisierungsagenten- und Serverumgebungen
  • Ermöglicht das Abrufen der neuesten Änderungen oder das dauerhafte Aktualisieren von Dateien
• Auf einem Gerät sollten Desktop Sync und Headless Sync nicht gleichzeitig verwendet werden, da das Risiko von Datenkonflikten besteht
• Die Installation erfolgt mit dem Befehl npm install -g obsidian-headless

Grundlegende Verwendung

• Anmeldung: ob login
• Liste der Remote-Vaults anzeigen: ob sync-list-remote
• Lokalen Vault einrichten: ob sync-setup --vault "My Vault"
• Einmalige Synchronisierung: ob sync
• Fortlaufende Synchronisierung: ob sync --continuous
• In nicht-interaktiven Umgebungen kann die Authentifizierung durch Setzen der Umgebungsvariable OBSIDIAN_AUTH_TOKEN automatisiert werden

Wichtige Befehle

• ob sync-list-remote: Zeigt alle Remote-Vaults des Kontos an, einschließlich freigegebener Vaults
• ob sync-list-local: Zeigt lokal eingerichtete Vaults und deren Pfade an
• ob sync-create-remote: Erstellt einen neuen Remote-Vault
  • Optionen: --name, --encryption(standard oder e2ee), --password, --region
• ob sync-setup: Richtet die Verknüpfung zwischen lokalem und Remote-Vault ein
  • Optionen: --vault, --path, --password, --device-name, --config-dir
• ob sync: Führt die Synchronisierung für den eingerichteten Vault aus
  • Mit der Option --continuous werden Änderungen überwacht und kontinuierlich synchronisiert
• ob sync-config: Zeigt die Synchronisierungseinstellungen eines Vaults an oder ändert sie
  • Es lassen sich Konfliktstrategie (merge/conflict), Dateitypen, zu synchronisierende Einstellungskategorien, auszuschließende Ordner usw. festlegen
• ob sync-status: Zeigt den Synchronisierungsstatus und die Einstellungen des Vaults an
• ob sync-unlink: Trennt den Vault von der Synchronisierung und löscht gespeicherte Zugangsdaten

Native Module

• Für Windows und macOS ist ein native Add-on enthalten, das die Erstellungszeit von Dateien (birthtime) setzt
  • Beim Herunterladen von Dateien vom Server bleibt die ursprüngliche Erstellungszeit erhalten
  • Zielt auf N-API-Version 3 und wahrt die ABI-Kompatibilität zwischen Node.js-Versionen
• Unter Linux wird birthtime nicht unterstützt, daher ist kein Add-on enthalten; die Synchronisierung funktioniert jedoch normal
• Ziele für vorgefertigte Binärdateien:
  • win32-x64, win32-arm64, win32-ia32, darwin-x64, darwin-arm64