LinuxCommandLibrary

maestral

lightweight Dropbox client for Linux and macOS

TLDR

Link to Dropbox account
$ maestral link
copy
Start syncing
$ maestral start
copy
Stop syncing
$ maestral stop
copy
Show sync status
$ maestral status
copy
Pause syncing
$ maestral pause
copy
Resume syncing
$ maestral resume
copy
List sync activity
$ maestral activity
copy
Exclude folder from sync
$ maestral excluded add [/path/to/folder]
copy

SYNOPSIS

maestral [start] [stop] [status] [link] [excluded] [options] [command]

DESCRIPTION

maestral is a lightweight Dropbox client for Linux and macOS. It provides file synchronization without the heavy resource usage of the official client.
The daemon runs in the background, monitoring local changes and syncing with Dropbox. Selective sync excludes unwanted folders to save disk space.
Unlike the official client, Maestral is open-source and uses fewer system resources. It supports the core sync functionality without extras like camera uploads or screenshots.
Multiple Dropbox accounts can be configured using different configuration names. Each runs as a separate daemon with its own sync folder.
The status command shows sync progress, conflicts, and errors. Activity shows recent file changes. Notifications alert on sync events.

PARAMETERS

start

Start the sync daemon.
stop
Stop the sync daemon.
restart
Restart the sync daemon.
status
Show current sync status.
pause
Pause syncing.
resume
Resume syncing.
link
Link to Dropbox account.
unlink
Unlink Dropbox account.
activity
Show recent sync activity.
excluded add PATH
Exclude folder from sync.
excluded remove PATH
Include previously excluded folder.
excluded list
List excluded folders.
ls PATH
List folder contents.
notify LEVEL
Set notification level.
autostart
Configure automatic startup.
config
Show configuration.

CAVEATS

No GUI by default - CLI only (optional GUI available). Some Dropbox features not supported. Requires Python. Initial sync of large accounts takes time.

HISTORY

Maestral was created by Sam Schott around 2018 as a lightweight alternative to the official Dropbox client for Linux. The name comes from the Mistral wind. It gained popularity among Linux users wanting Dropbox sync without Electron or heavy dependencies.

SEE ALSO

rclone(1), syncthing(1), dropbox(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard