Owlfiles CLI — Kommandozeile

Mit Owlfiles für macOS können Sie Dateien in jeder Owlfiles-Verbindung direkt im Terminal auflisten, suchen, kopieren, verschieben und löschen – auf lokalen Laufwerken, über SMB, FTP, SFTP, WebDAV und NFS sowie in der Cloud.

In wenigen Sekunden startklar

Die CLI ist in Owlfiles für macOS enthalten. Sie verwendet das Programm von Owlfiles selbst und greift auf die Verbindungen und gespeicherten Anmeldungen zurück, die Sie bereits in der App eingerichtet haben. Eine zusätzliche Konfiguration ist daher nicht nötig.

Starten Sie die CLI im Terminal über den vollständigen Pfad:

/Applications/Owlfiles.app/Contents/MacOS/Owlfiles connections

Um Tipparbeit zu sparen, können Sie einen Shell-Alias anlegen. Fügen Sie für die standardmäßige zsh-Shell den folgenden Eintrag zu ~/.zshrc hinzu und öffnen Sie danach ein neues Terminalfenster:

# Zu ~/.zshrc hinzufügen und danach ein neues Terminalfenster öffnen
alias owlfiles="/Applications/Owlfiles.app/Contents/MacOS/Owlfiles"

Anschließend genügt die Eingabe von owlfiles. Die folgenden Beispiele setzen diesen Alias voraus.

Dateien adressieren

Die meisten Befehle erwarten eine Adresse im Format <Verbindung>:<Pfad>. Dabei ist Verbindung der Name, den owlfiles connections anzeigt.

  • MyNAS:/Documents/report.pdf — eine Datei in der Verbindung mit dem Namen „MyNAS“.
  • GDrive:1zeRs1TUOYxMwVdYJdHF_ikAaRCMYMcwp — Google Drive verwendet eine ID als Pfad.
  • local:~/Desktop oder ~/Desktop — Dateien auf Ihrem Mac. Wenn keine Verbindung angegeben ist, wird die Adresse als lokaler Pfad behandelt.

Enthält der Name einer Verbindung ein Leerzeichen, setzen Sie die gesamte Adresse in Anführungszeichen, zum Beispiel “my NAS:/Documents”. Bei Cloud-Diensten können Sie anstelle des Pfads auch die ID einer Datei verwenden. Die ID wird in den Ergebnissen des Befehls ls angezeigt.

Häufig verwendete Befehle

Jeder Befehl gibt bei Erfolg den Exit-Status 0 und bei einem Fehler einen Wert ungleich 0 zurück. Fehlermeldungen werden auf die Standardfehlerausgabe geschrieben, sodass sich die CLI gut in Shell-Skripten einsetzen lässt.

# Verbindungen auflisten (Name und Protokoll)
owlfiles connections

# Ordnerinhalt auflisten (-a schließt versteckte Dateien ein)
owlfiles ls "my NAS:/Documents"
owlfiles ls -a MyGoogleDrive:'1WlBH4KpOcIWgNKVVBRmUd5'

# Dateiinformationen / Metadaten (Typ, Größe, Änderungsdatum)
owlfiles info "my NAS:/Documents/report.pdf"

# Nach Schlüsselwort suchen (Groß-/Kleinschreibung wird ignoriert)
owlfiles search "my NAS:/Documents" invoice
owlfiles search Dropbox report.pdf

# Ordner erstellen
owlfiles mkdir "my NAS:/Documents/Archive"

# Zwischen Verbindungen kopieren (NAS → Cloud verwendet die Datei-ID)
owlfiles cp "my NAS:/Documents/report.pdf" GDrive:'1WlBH4KpOBl8WXj31pOcIW'
owlfiles cp /Users/me/Desktop/photo.jpg "my NAS:/Photos"

# Verschieben / umbenennen, auch zwischen Verbindungen
owlfiles mv "my NAS:/Documents/report.pdf" MyOneDrive:'CF8821A253295DA6!142'

# Löschen (ohne Sicherheitsabfrage – mit Bedacht verwenden)
owlfiles rm "my NAS:/Documents/old.txt"

# Vollständige Befehlsübersicht
owlfiles --help

Wissenswertes

Namen und Anmeldung

Mit owlfiles connections sehen Sie die exakten Namen Ihrer Verbindungen. Setzen Sie Namen mit Leerzeichen in Anführungszeichen. Wenn eine Verbindung eine Anmeldung verlangt, öffnen Sie sie einmal in der Owlfiles-App. Danach verwendet die CLI dieselben gespeicherten Anmeldedaten.

Lokale Dateien und die Sandbox

Owlfiles wird in der macOS App Sandbox ausgeführt. Die CLI kann nur dann auf einen Ordner Ihres lokalen Laufwerks zugreifen, wenn Sie ihn zuvor einmal in der Owlfiles-App geöffnet haben. Dateien in Remote- und Cloud-Verbindungen sind davon nicht betroffen.