CLI utility to sync config files, dot files, and directories across UNIX machines using Dropbox.
Last updated 4 years ago by georgewsinger .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install drop-dot 
SYNC missed versions from official npm registry.


drop logo

Dot-drop is simple node.js utility that helps you sync your .config files/directories across multiple Unix computers using Dropbox.

First, install drop-dot via npm:

$ npm install -g drop-dot

Next, create a .drop-dot folder in your ~/Dropbox directory along with an empty configuration file:

$ mkdir ~/Dropbox/.drop-dot
$ touch ~/Dropbox/.drop-dot/.drop-dot

Then, populate this .drop-dot file with a list of the files and/or directories that you wish to sync with Dropbox. For example, the contents of your .drop-dot might look like the following:


Note: You are free to use the ~ symbol in this file to denote your home folder, but cannot (presently) use environment variables (i.e., $HOME, etc).

After you populate your config file, you can use drop-dot to place its files into your ~/Dropbox/.drop-dot folder:

$ drop-dot drop # on Computer #1

In case you are curious, this is equivalent to running -- for each /path/to/file_or_dir written inside ~/Dropbox/.drop-dot/.drop-dot -- the following two commands:

  $ sudo mv /path/to/file_or_dir ~/Dropbox/.drop-dot/file_or_dir
  $ sudo ln -s ~/Dropbox/.drop-dot/file_or_dir /path/to/file_or_dir

Finally, migrate to any other Unix computer synced to your Dropbox account, and run the following command:

$ drop-dot link

You're done.

What this last command does is the following: for each /path/to/file_or_dir inside ~/Dropbox/.drop-dot, drop-dot creates a symlink corresponding to this address that points to the appropriate corresponding file/directory inside your ~/Dropbox/.drop-dot folder. This is equivalent to the following:

$ sudo ln -s ~/Dropbox/.drop-dot/file_or_dir /path/to/file_or_dir

Graphical Representation

Here is a graphical representation of how this program would go about syncing ~/file1:

Alt Text

If you don't know what a "symlink" is, check out this.


  • A Unix system (i.e., linux or mac)
  • Dropbox

Is this program safe?

This program is designed to never eat, move, or link a file if any sort of system conflict exists (you'll just get an error message printed to your console); however, use this at your own risk (and always make backups :)


  • Add the ability to individually add and remove files (instead of relying on a config file): i.e.:

    $ drop-dot drop <file1> ... <filen> $ drop-dot remove <file1> ... <filen>

  • Add drop-dot status:

    $ drop-dot status All of your files are synced!

‐ Improve readability of error messages

  • Allow the usage of environment variables in configuration files


Dot-drop is written in ClojureScript and transpiled to pure nodejs.

Current Tags

  • 0.0.2                                ...           latest (4 years ago)

2 Versions

  • 0.0.2                                ...           4 years ago
  • 0.0.1                                ...           4 years ago
Maintainers (1)
Today 0
This Week 0
This Month 1
Last Day 0
Last Week 0
Last Month 1
Dependencies (2)
Dev Dependencies (0)
Dependents (1)

Copyright 2014 - 2016 © taobao.org |