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.

Requirements

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.

Installation

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.

Usage

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

Commands

Examples

Notes

• 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.

License

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