maestral
v1.9.4
Ein leichter und Open-Source-Dropbox-Client für macOS und Linux.
Maestral ist ein Open-Source-Dropbox-Client in Python. Das Hauptziel des Projekts ist es, einen Client für Plattformen und Dateisysteme bereitzustellen, die nicht mehr direkt von Dropbox unterstützt werden.
Maestral unterstützt derzeit kein Dropbox -Papier, die Verwaltung von Dropbox -Teams und die Verwaltung gemeinsamer Ordnereinstellungen. Wenn Sie eine dieser Funktionen benötigen, verwenden Sie bitte die Dropbox -Website oder den offiziellen Kunden. Maestral unterstützt die Synchronisierung mehrerer Dropbox -Konten und die Ausnahme lokaler Dateien von Sync mit einer ".Mignore" -Datei.
Der Fokus auf die "einfache" Dateisynchronisierung wird mit Vorteilen geliefert: Auf macOS ist das Maestral App -Bundle deutlich kleiner als die offizielle Dropbox -App und verwendet weniger Speicher. Die genaue Speicherverwendung hängt von der Größe Ihres synchronisierten Dropbox -Ordners ab und kann beim Ausführen von Maestral ohne GUI weiter reduziert werden.
Maestral verwendet die öffentliche Dropbox -API, die im Gegensatz zum offiziellen Kunden nicht nur die Übertragung der Teile einer Datei unterstützt, die sich geändert hat ("Binärdiff"). Maestral kann daher mehr Bandbreite verwenden als der offizielle Kunde. Es wird jedoch vermieden, eine Datei hochzuladen oder herunterzuladen, wenn sie bereits lokal oder in der Cloud mit denselben Inhalten vorhanden ist.
Für MacOS Catalina und höher wird ein App -Bundle bereitgestellt und kann von der Registerkarte "Releases" heruntergeladen werden. Dieses App -Bundle ist auch als Homebrew -Fasspaket.
Auf anderen Plattformen können Sie Maestral als Python -Paket von PYPI oder als Docker -Bild von Docker Hub herunterladen und installieren.
Weitere detailliertere Informationen zu den Anforderungen an die Installation, Einrichtung und System finden Sie in der Dokumentation.
Die offiziellen Maestral -Veröffentlichungen sind ebenfalls als Homebrew -Fässer erhältlich. Wenn Sie ein Homebrew in Ihrem System haben, können Sie mit:
$ brew install maestralEs wird empfohlen, Maestral in einer virtuellen Umgebung wie folgt zu installieren:
$ python3 -m venv maestral-venv
$ source maestral-venv/bin/activate
(maestral-venv)$ python3 -m pip install --upgrade maestral Wenn Sie die grafische Benutzeroberfläche verwenden möchten, müssen Sie auch die GUI -Option während der Installation oder des Upgrades angeben. Dadurch werden die maestral-qt Frontend und PyQt5 unter Linux und maestral-cocoa auf MacOS installiert:
(maestral-venv)$ python3 -m pip install --upgrade 'maestral[gui]'Ein Docker -Image ist für X86, ARM/V7 (32bit) und ARM64 -Plattformen verfügbar und kann mit:
$ docker pull maestraldbx/maestral
Führen Sie maestral gui in der Befehlszeile aus (oder öffnen Sie die Maestral -App auf macOS), um Maestral mit einer grafischen Benutzeroberfläche zu starten. Beim ersten Lauf führt Maestral Sie durch das Verknüpfen und Konfigurieren Ihrer Dropbox und beginnt mit der Synchronisierung.
Nach der Installation ist Maestral als Befurdr ess Zeilenskript verfügbar, indem maestral in der Eingabeaufforderung eingegeben wird. Geben Sie maestral --help ein, um eine vollständige Liste der verfügbaren Befehle zu erhalten. Das Wichtigste sind:
maestral gui : Startet die Maestral -GUI. Erstellt einen Synchronisationsimon, wenn es nicht bereits ausgeführt wird.maestral start|stop : Startet oder stoppt den Maestral -Synchronisations -Daemon.maestral pause|resume : Pausen oder Lebensläufe synchronisiert.maestral autostart -Y|-N : Setzt den Daemon, um sich mit dem Anmelden zu starten.maestral status : Erhält den aktuellen Status von Maestral.maestral filestatus LOCAL_PATH : Ruft den Synchronisierungsstatus einer einzelnen Datei oder eines einzelnen Ordners ab.maestral excluded add|remove|list : Befehlsgruppe zum Verwalten ausgeschlossener Ordner.maestral ls DROPBOX_PATH : Listet den Inhalt eines Verzeichnisses auf Dropbox auf.maestral notify snooze N : Snoozes Desktop -Benachrichtigungen für n Minuten. Maestral unterstützt die Synchronisierung mehrerer Dropbox -Konten, indem mehrere Instanzen mit verschiedenen Konfigurationsdateien ausgeführt werden. Dies muss aus der Befehlszeile konfiguriert werden, indem die Option übergeben wird --config-name an maestral start oder maestral gui . Maestral wählt dann eine vorhandene Konfiguration mit dem angegebenen Namen aus oder erstellt eine neue. Zum Beispiel:
$ maestral start --config-name= " personal "
$ maestral start --config-name= " work " Dies beginnt zwei Fälle von Maestral und synchronisiert ein privates bzw. ein Arbeitskonto. Konfigurationen werden beim Abnehmen eines Kontos automatisch gelöscht. Sie können alle aktuell verknüpften Konten mit maestral config-files auflisten. Das obige Setup gibt beispielsweise Folgendes auf macOS zurück:
$ maestral config-files
Config name Account Path
maestral [email protected] ~/Library/Application Support/maestral/maestral.ini
private [email protected] ~/Library/Application Support/maestral/private.iniStandardmäßig enthalten die Namensnamen des Dropbox-Ordners den kapitalisierten Konfigurationsnamen in Klammern. Im obigen Fall lautet dies "Dropbox (persönlich)" und "Dropbox (Arbeit)".
Eine vollständige Dokumentation der CLI ist auf der Website verfügbar.
Es gibt mehrere Themen, die Ihre Hilfe verwenden könnten. Einige von ihnen sind einfach, z. B. das Hinzufügen neuer CLI-Befehle, andere erfordern mehr Erfahrung, z. B. Verpackungen für Nicht-Makos-Plattformen. Achten Sie auf Probleme, die mit "Good First Ausgabe" oder "Hilfe gesucht" gekennzeichnet sind.
Relevante Ressourcen sind:
Beitragen.md enthält detaillierte Informationen zum erwarteten Codestil und zum Testformat.
Wenn Sie das MacOS -App -Bundle verwenden, sollten Sie das Projekt mit 1 GBP pro Monat sponsern, um die Kosten für ein Apple -Entwicklerkonto auszugleichen, um das Bundle zu unterschreiben und zu notarisieren.
