Restore any dropbox folder to a previous state
Switch branches/tags
Nothing to show
Clone or download
Latest commit 20a522f Dec 12, 2017


The Dropbox API changed and this script no longer works; you can try using though it does not restore to the exact previous state

Restore any dropbox folder to a previous state. If a file did not exist at the specified time, it will be deleted.


To restore the folder "/photos/nyc" to the way it was on March 9th, 2013:

python2.7 /photos/nyc 2013-03-09

Note that the path "/photos/nyc" should be relative to your Dropbox folder; it should not include the path to the Dropbox folder on your hard drive. You will be prompted to confirm access to your Dropbox account through your web browser.


  1. Obtain Dropbox APP_KEY and APP_SECRET by creating a Dropbox App:

  2. Make sure that Python 2.7 and pip are installed.

  3. Then install the Dropbox Python API with the following command.

    sudo pip install dropbox

  4. Download from Github

  5. Insert APP_KEY and APP_SECRET at the top of


Specifying a time is not officially supported because the time zone is ignored currently. However, it seems like Dropbox always uses UTC, so you can try specifying UTC times at your own risk by specifying the date and time in the format YYYY-MM-DD-HH-MM-SS on the command line. Be warned that Dropbox's documentation does not guarantee that they will always use UTC, so this can break at any time.


If you would like to make a donation, you can use the PayPal button on my website: