https://github.com/coolaj86/dropshare

A min.us / ge.tt file share clone.
https://github.com/coolaj86/dropshare

Last synced: 12 days ago
JSON representation

A min.us / ge.tt file share clone.

• Host: GitHub
• URL: https://github.com/coolaj86/dropshare
• Owner: coolaj86
• License: apache-2.0
• Fork: true (stanleystuart/dropshare)
• Created: 2012-03-23T22:28:55.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2015-08-06T18:34:39.000Z (over 9 years ago)
• Last Synced: 2024-08-01T16:48:27.668Z (3 months ago)
• Language: JavaScript
• Homepage: http://dropsha.re
• Size: 1.48 MB
• Stars: 12
• Watchers: 5
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.APACHE2

Awesome Lists containing this project

README

        
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/[email protected]'

    

    curl 'http://api.dropsha.re/files/foHsCQA' -o '[email protected]'

### 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 .

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