Mirrorworks
A handy rsync wrapper cli tool.
This is a dead-simple script that lets you easily set up pairs of files or
directories (called 'reflections') and sync them locally or over the network
with commands like
$ mirrorworks push
and
$ mirrorworks pull
Installation and Configuration
For Windows users, install cygwin.
Make sure you have rsync and ruby installed.
Install the gem with
$ gem install mirrorworks
Mirrorworks reads a configuration file at ~/.mirrorworksrc.json.
To create an example config file run:
$ mirrorworks install
This file contains some underlying rsync runtime options as well as a set of 'reflections'. Reflections are pairs files or directories that you want to have synchronized. Each consists of a name, a local file/dir, and a remote file/dir. There are a few things to remember when setting up your reflections:
- The name of each reflection should be unique and should not include spaces.
- Directory paths should end in a slash /.
- You can use '$HOME' or '~' to refer to your home directory.
- On windows, use cygwin style paths; for example, '/cygdrive/c/...'
Using Mirrorworks
The script is very straightforward. For usage, run
$ mirrorworks --help
Development
For bug reports and feature requests, feel free to open an issue or make a pull request on github.