maestral
v1.9.4
Un client dropbox léger et open-source pour macOS et Linux.
Maestral est un client dropbox open-source écrit en python. L'objectif principal du projet est de fournir un client pour les plates-formes et les systèmes de fichiers qui ne sont plus directement pris en charge par Dropbox.
Maestral ne prend actuellement pas en charge le papier Dropbox, la gestion des équipes Dropbox et la gestion des paramètres de dossiers partagés. Si vous avez besoin d'une de ces fonctionnalités, veuillez utiliser le site Web Dropbox ou le client officiel. Maestral prend en charge la synchronisation plusieurs comptes Dropbox et l'exclusion des fichiers locaux à partir de la synchronisation avec un fichier ".mignore".
L'accent mis sur la synchronisation «simple» des fichiers est venu avec des avantages: sur MacOS, le bundle d'applications maestral est nettement plus petit que l'application Dropbox officielle et utilise moins de mémoire. L'utilisation exacte de la mémoire dépendra de la taille de votre dossier Dropbox synchroné et peut être encore réduite lors de l'exécution de Maestral sans GUI.
Maestral utilise l'API publique Dropbox qui, contrairement au client officiel, ne prend pas en charge le transfert uniquement des parties d'un fichier qui a changé ("Diff binaire"). Maestral peut donc utiliser plus de bande passante que le client officiel. Cependant, cela évitera de télécharger ou de télécharger un fichier s'il existe déjà avec le même contenu localement ou dans le cloud.
Un bundle d'applications est fourni pour MacOS Catalina et supérieur et peut être téléchargé à partir de l'onglet des versions. Ce bundle d'applications est également un package en fût de homebrew.
Sur d'autres plates-formes, vous pouvez télécharger et installer Maestral en tant que package Python de PYPI ou comme une image Docker de Docker Hub.
Pour des informations plus détaillées sur l'installation, la configuration et les exigences du système, veuillez vérifier la documentation.
Les sorties maestrales officielles sont également disponibles sous forme de fûts de homebrew. Si vous avez Homebrew sur votre système, vous pouvez installer en utilisant:
$ brew install maestralEst recommandé d'installer Maestral dans un environnement virtuel comme suit:
$ python3 -m venv maestral-venv
$ source maestral-venv/bin/activate
(maestral-venv)$ python3 -m pip install --upgrade maestral Si vous avez l'intention d'utiliser l'interface utilisateur graphique, vous devez également spécifier l'option GUI pendant l'installation ou la mise à niveau. Cela installera le frontal maestral-qt et PyQt5 sur Linux et maestral-cocoa sur macOS:
(maestral-venv)$ python3 -m pip install --upgrade 'maestral[gui]'Une image Docker est disponible pour les plates-formes X86, ARM / V7 (32 bits) et ARM64 et peut être installée avec:
$ docker pull maestraldbx/maestral
Exécutez maestral gui dans la ligne de commande (ou ouvrez l'application Maestral sur macOS) pour démarrer Maestral avec une interface utilisateur graphique. Lors de sa première exécution, Maestral vous guidera dans la liaison et la configuration de votre Dropbox et commencera ensuite à vous synchroniser.
Après l'installation, Maestral sera disponible en tant que script de ligne de commande en tapant maestral dans l'invite de commande. Tapez maestral --help pour obtenir une liste complète des commandes disponibles. Les plus importants sont:
maestral gui : commence l'interface graphique maestrale. Crée un démon de synchronisation s'il n'est pas déjà en cours d'exécution.maestral start|stop : Démarrage ou arrête le démon de synchronisation maestral.maestral pause|resume : Pauses ou reprise de la synchronisation.maestral autostart -Y|-N : Définit le démon pour commencer à se connecter.maestral status : obtient le statut actuel du maestral.maestral filestatus LOCAL_PATH : obtient l'état de synchronisation d'un fichier ou d'un dossier individuel.maestral excluded add|remove|list : groupe de commandes pour gérer les dossiers exclus.maestral ls DROPBOX_PATH : répertorie le contenu d'un répertoire sur Dropbox.maestral notify snooze N : Snoozes Notifications de bureau pendant n minutes. Maestral prend en charge la synchronisation de plusieurs comptes Dropbox en exécutant plusieurs instances avec différents fichiers de configuration. Cela doit être configuré à partir de la ligne de commande en passant l'option --config-name au maestral start ou à maestral gui . Maestral sélectionnera ensuite une configuration existante avec le nom donné ou en créera un nouveau. Par exemple:
$ maestral start --config-name= " personal "
$ maestral start --config-name= " work " Cela commencera deux instances de Maestral, synchronisant un compte privé et un compte de travail, respectivement. Les configurations seront automatiquement effacées lors de la non-désagrément d'un compte. Vous pouvez répertorier tous les comptes actuellement liés avec maestral config-files . La configuration ci-dessus par exemple renverra ce qui suit sur macOS:
$ maestral config-files
Config name Account Path
maestral [email protected] ~/Library/Application Support/maestral/maestral.ini
private [email protected] ~/Library/Application Support/maestral/private.iniPar défaut, les noms de dossiers Dropbox contiendront le nom de configuration capitalisé en accolades. Dans le cas ci-dessus, ce sera "Dropbox (personnel)" et "Dropbox (Work)".
Une documentation complète de la CLI est disponible sur le site Web.
Il existe plusieurs sujets qui pourraient utiliser votre aide. Certains d'entre eux sont faciles, comme l'ajout de nouvelles commandes CLI, d'autres nécessitent plus d'expérience, comme l'emballage pour les plates-formes non MacOS. Recherchez les problèmes marqués par le "bon premier numéro" ou "Aide recherché".
Les ressources pertinentes sont:
Contribution.md contient des informations détaillées sur le style de code et le format de test attendus.
Si vous utilisez le pack d'applications MacOS, veuillez envisager de parrainer le projet avec 1 £ par mois pour compenser le coût d'un compte de développeur Apple pour signer et notoriser le bundle.
