DribbbleBucketSync

Dribbble doesn't offer a solution to backup or sync your buckets and their containing shots to your computer. This gem solves that.

You can sync to any local directory you wish, a folder will be created for each bucket, and the shots will be downloaded therein.

Upon subsequent syncing, the list of shots in a bucket will be downloaded, any missing shots will be downloaded, and any shots no longer in the bucket will be removed.

Installation

Note: requires Ruby 1.9

Add this line to your application's Gemfile:

gem "dribbble-bucket-sync"

And then execute:

$ bundle

Or install it yourself as:

$ gem install dribbble-bucket-sync

Usage

There is a command-line script to access the synchronisation:

$ dribbble_bucket_sync dribbble_username path/to/dir

Output should be like this:

$ dribbble_bucket_sync ryantownsend ~/dribbble
Starting synchronisation...
ryantownsend has 29 buckets.
Timelines has 20 shots.
Connecting to dribbble.s3.amazonaws.com:80
Downloading 20 files:
....................
Infographics has 12 shots.
[...]
Synchronisation complete.

The syntax to run within your own app is fairly straight-forward:

require "dribbble_bucket_sync"
# create a location to store the files
directory = File.join(File.dirname(__FILE__), "data")
# start the synchronisation
DribbbleBucketSync.new("ryantownsend").sync_to(directory)

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request