Skip to main content

A simple command line wrapper for rclone focused on easy folder syncing

Project description

rcl - A simple command line wrapper for rclone.

rcl is a simple command line wrapper for rclone focused on easy folder syncing. It is loosely based on git's interface and therefore uses the concepts of "local" and "remote" along with having commands such as pull, push and diff.

Feel free to raise any issues, suggest improvements and features or fork and contribute.


rcl only acts as a wrapper around rclone, you therefore must first install and configure rclone and ensure that it is properly accessible on your PATH.


rcl is available on PyPI and can be installed by running pip install rcl.

Note: It is possible that pip will warn you that the install location is not on your$PATH. If so, rcl may not be found until you add the directory shown in the warning to your $PATH.


To use rcl you add entries which consist of local/remote folder pairs. You can then interact with these entries like they're a connected system.

The folder values you add to entries will directly match what rclone uses and should conform to rclone's interface of:

  • Local Folder: /local/path/to/folder
  • Remote Folder: remote:path/to/folder


Command Explanation
rcl / rcl --help Outputs the help and a list of commands.
rcl add <entry_id> <local_folder> <remote_folder> Add a new entry, identified by <entry_id>.
rcl diff <entry_id> Show the difference between the local and remote folder.
rcl list List all entries.
rcl pull <entry_id> [--dry] Pull remote changes to your local. (Sync local to match remote).
rcl push <entry_id> [--dry] Push local changes to the remote. (Sync remote to match local).
rcl rm <entry_id> Remove an entry.


Example Explanation
rcl add music /home/user/Music gdrive:Music Add a new "music" entry linking the default Linux Music folder with a top-level "Music" folder in a remote called "gdrive".
rcl push music Push local changes to the remote. (Sync remote with local).
rcl pull music Pull remote changes to your local. (Sync local with remote).
rcl rm music Remove the "music" entry.


  • push and pull can both be run with the --dry flag which will add --dry-run to the rclone command.
  • push and pull automatically add the --progress flag to the rclone command.
  • rcl can be run from any directory as it will always run rclone using the local/remote folders from the entry specified.

Current Limitations

  • Opinionated - This wrapper offers a simple interface for specific aspects of syncing I use.
  • Manual External Setup - rclone still has to be setup externally prior to use.
  • No Input vAl1dation - None of the values supplied to the add command are validated in any way.
  • Error Handling - There is some python error handling on rcl rm but nothing protecting against invalid inputs to rcl add or rclone errors.


rcl is release under the GNU GPLv3 license so you can use and adapt as you wish.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rcl-0.1.2.tar.gz (4.1 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page