Dropshare
===

[DropShare](http://dropsha.re) is the answer to the age-old question of File Transfer:

[![File Transfer][file-transfer]][xkcd-949]

[xkcd-949]: http://xkcd.com/949/
[file-transfer]: http://imgs.xkcd.com/comics/file_transfer.png "Every time you email a file to yourself so you can pull it up on your friend's laptop, Tim Berners-Lee sheds a single tear."

Similar services include

  * [ge.tt](http://ge.tt)
  * [min.us](http://min.us)
  * [droplr](http://droplr.com)
  * [kicksend](http://kicksend.com/)
  * [sendoid](http://sendoid.com/)
  * [shareDesk](http://sharedesk.at) [[fork on github](https://github.com/eeezyy/shareDesk)]
  * [CloudApp](http://getcloudapp.com/)

Clients
===

A few different clients are avaible.

Web
---

With the web-client you can drag-n-drop or use the normal upload/download.

[http://dropsha.re](http://dropsha.re)

Commandline
---

**Usage**

    dropshare /path/to/file.ext
    
    # Example - share your public ssh key with someone
    dropshare ~/.ssh/id_rsa.pub
    
**Example Output**

    Your file, Sir! (or Ma'am):
    
    http://dropsha.re/#foHsCQA
    
    wget 'http://api.dropsha.re/files/foHsCQA/coolaj86@ubuntu-tablet.pub'
    
    curl 'http://api.dropsha.re/files/foHsCQA' -o 'coolaj86@ubuntu-tablet.pub'

### Python Client

    sudo wget 'https://raw.github.com/SpotterRF/dropshare/master/clients/dropshare.py' -O '/usr/local/bin/dropshare'
    sudo chmod a+x '/usr/local/bin/dropshare'

### Bash Client

    sudo wget 'https://raw.github.com/SpotterRF/dropshare/master/clients/dropshare.sh' -O '/usr/local/bin/dropshare'
    sudo chmod a+x '/usr/local/bin/dropshare'

Server
===

If you're interested in consulting or setup to run DropShare on your private network
at your Home Office, or Business please contact <coolaj86@gmail.com>.

Quick Start for Running your own DropShare
---

If you don't want to customize it at all you can install it via npm

  0. Download [NodeJS](http://nodejs.org#download)
  1. `npm install -g dropshare`
  2. `dropshare-server`
  3. The database will be in `dropshare/server/lib/db/db.json`

But for production use with a real database

  0. Install [NodeJS](http://nodejs.org): [Linux Binary](https://github.com/joyent/node/wiki/Installing-Node.js-via-package-manager) | [Linux Source](http://apptob.org) | [OS X | Windows](http://nodejs.org#download).
  0. Install `redis`. See Appendix (below) for installing redis on OS X.

        # Ubuntu Linux
        sudo apt-get install redis-server
        
        # OS X
        brew install redis
        launchctl load -w ~/Library/LaunchAgents/io.redis.redis-server.plist
        # see notes below

  0. Install `jade`, [Pakmanager](https://github.com/coolaj86/node-pakmanager), `less`, and some other fun things.

        npm install -g jade less pakmanager uglify-js

  0. Install dropshare in your webapps directory (I use [connect-vhoster](https://github.com/coolaj86/connect-vhoster))

        # use mine (or use your own fork)
        git clone git://github.com/SpotterRF/dropshare.git dropshare.example.com

  0. Copy `config.default.js` to `config.js`, and customize any server
     settings you would like.

        cd dropshare.example.com
        rsync -a config.default.js config.js

  0. Download dependencies and compile the static assets.
     (You may wish to look at `deploy.sh` to understand what it does)

        ./deploy.sh # possibly needs `sudo`

  0. Start the server. By default it runs on port 3700 (but if it's different, you'll see it).

        node bin/dropshare-server.js


Server Parameters
---
The server can take parameters in a few forms. If you are just running a
stand-alone server, then you can put them in the `config.js` file. If
you are creating a Dropshare server in code, then you can pass an object
in to the `create()` method exported by `lib/index.js`. 

The parameters all have sensible defaults that should work out of the box,
so you don't actually need any of them.

* `client`: the path to the public folder for the browser interface.
  Defaults to `./public`
* `storageDir`: a path to a directory to store uploaded files. Defaults to `./files`.
* `allowUserSpecifiedIds`: if true, allow users to specify the ids that files
   will be stored under.

Running Tests
---

Run the tests with:

    cd tests
    ./test.sh

The tests depend on being in the same directory as the test script, due
to paths to resources and such.


LICENSE
===

Dropshare is available under the following licenses:

  * MIT
  * Apache 2

Copyright 2011 - 2012 Jamison Dance and AJ ONeal

Appendix
===

Installing Redis
---

    brew install redis

    mkdir -p ~/Library/LaunchAgents

    launchctl unload -w ~/Library/LaunchAgents/io.redis.redis-server.plist 2>/dev/null || true
    cp /usr/local/Cellar/redis/2.2.12/io.redis.redis-server.plist ~/Library/LaunchAgents/
    launchctl load -w ~/Library/LaunchAgents/io.redis.redis-server.plist

**To start redis manually:**

    redis-server /usr/local/etc/redis.conf

**To access the server:**
    redis-cli

Ubuntu Linux
---

    sudo apt-get install redis-server # may be called just 'redis', depending on your distro