用于MacOS和Linux的开源Dropbox客户端。
maestral的Python项目详细描述
maestral
一个轻量级的开源Dropbox客户端,适用于MacOS和Linux。
关于
maestral是一个用python编写的开源dropbox客户端。该项目的主要目标是 为不再直接受 升降箱。
目前,Maestral不支持Dropbox Paper,Dropbox团队的管理和 共享文件夹设置的管理。如果你需要这些功能,请 使用Dropbox网站或官方客户端。但是,从v0.3开始,maestral 支持同步多个Dropbox帐户。
对“简单”文件同步的关注确实带来了一些好处:MacOS上的Maestral应用程序 比官方Dropbox应用程序小80%(50MB比290MB),使用的内存少70%。这个 安装和运行maestral时,应用程序大小和内存占用可以进一步减少 没有gui,使用操作系统提供的python安装。马斯特拉尔法典 它本身和它的python依赖项占用不到3mb,使得安装过程中没有gui 非常适合资源很少的系统。
安装
为MacOS High Sierra及更高版本提供二进制文件,可从 释放选项卡。在其他平台上,从pypi下载并安装python包:
$ python3 -m pip install --upgrade maestral
您还可以安装最新的测试版:
$ python3 -m pip install --upgrade --pre maestral
如果要使用图形用户界面,还需要安装pyqt5 从pypi或者从平台包管理器中。
用法
在命令行中运行maestral gui
(或在macos上打开maestral应用程序)以启动
带有图形用户界面的Maestral。在它的第一次运行中,Maestral将指导您
通过链接和配置Dropbox,然后将开始同步。
命令行用法
安装后,maestral将作为命令行脚本提供,方法是键入
maestral
在命令提示符下。键入maestral --help
获取可用的完整列表
命令。最重要的是:
maestral gui
:用gui启动maestral。maestral daemon {start/stop}
:启动或停止maestral作为守护进程。maestral daemon {pause/resume}
:暂停或继续同步。maestral daemon status
:获取当前同步状态。maestral daemon errors
:列出所有同步错误。maestral set-dir
:设置本地Dropbox文件夹的位置。maestral dir-exclude
:不同步Dropbox文件夹。maestral dir-inlcude
:同步时包含Dropbox文件夹。maestral ls
:列出dropbox上目录的内容。maestral log
:显示和清除日志、设置日志级别等的命令组。
Maestral目前通过运行多个
实例。这需要从命令行完成。例如,在运行之前
maestral gui
,可以使用maestral config new
设置新配置。这个
配置名称应该作为命令行选项--config-name
在
运行Maestral。例如:
$ maestral config new "personal" $ maestral config new "work" $ maestral gui --config-name="personal" $ maestral gui --config-name="work"
这将启动两个Maestral实例,同步一个私人帐户和一个工作帐户, 分别是。还支持多个maestral守护进程。
默认情况下,dropbox文件夹名称将包含大括号中大写的配置名称。 在上述情况下,这将是“Dropbox(个人)”和“Dropbox(工作)”。
贡献
以下任务可能需要您的帮助:
- []为Maestral编写测试。
- []在不支持的Dropbox文件夹位置(网络驱动器, 外部硬盘等)。
- []本地Cocoa和GTK接口。Maestral目前使用Pyqt5。
- []打包:改进MacOS打包(减少应用程序大小)和其他平台打包。
警告:
- Maestral仍处于测试状态。即使不太可能,使用它可能 导致数据丢失。
- 网络驱动器和一些不支持将外部硬盘驱动器作为 Dropbox文件夹。
依赖关系
- MacOS(二进制为10.13或更高版本)或Linux
- python 3.6或更高版本
- 仅适用于图形用户界面:
- Pyqt 5.9或更高
- gnome-shell-extension-appindicator 在GNOME 3.26及更高版本上
致谢
- 配置模块使用来自Spyder IDE的代码。
- maestralapiclient基于Orphilia的工作。