sharedrop README

The project's README from github.com/ShareDropio/sharedrop. As one markdown file: README.md.

ShareDrop

ShareDrop is now LimeWire

Dear ShareDrop community, ShareDrop has been acquired by LimeWire, a leading file sharing platform with integrated AI tools. You can continue to share any files between devices, while benefitting from:

Visit sharedrop.io or limewire.com

The Github repository will stay as-is and you can still go ahead and download and run the classic ShareDrop on your own infrastructure.

ShareDrop Classic

ShareDrop is a web application inspired by Apple AirDrop service. It allows you to transfer files directly between devices, without having to upload them to any server first. It uses WebRTC for secure peer-to-peer file transfer and Firebase for presence management and WebRTC signaling.

ShareDrop allows you to send files to other devices in the same local network (i.e. devices with the same public IP address) without any configuration - simply open https://www.sharedrop.io on all devices and they will see each other. It also allows you to send files between networks - just click the + button in the top right corner of the page to create a room with a unique URL and share this URL with other people you want to send a file to. Once they open this page in a browser on their devices, you'll see each other's avatars.

The main difference between ShareDrop and AirDrop is that ShareDrop requires Internet connection to discover other devices, while AirDrop doesn't need one, as it creates ad-hoc wireless network between them. On the other hand, ShareDrop allows you to share files between mobile (Android and iOS) and desktop devices and even between networks.

Supported browsers

Local development

  1. Setup Firebase:
    1. Sign up for a Firebase account and create a database.
    2. Go to "Security Rules" tab, click "Load Rules" button and select firebase_rules.json file.
    3. Take note of your database URL and its secret, which can be found in "Secrets" tab.
  2. Run npm install -g ember-cli to install Ember CLI.
  3. Run yarn to install app dependencies.
  4. Run cp .env{.sample,} to create .env file. This file will be used by Foreman to set environment variables when running the app locally.
    • SECRET key is used to encrypt cookies and generate room name based on public IP address for / route. It can be any random string - you can generate one using e.g. date | md5sum
    • NEW_RELIC_* keys are only necessary in production
  5. Run yarn develop to start the app.

Deployment

Heroku

Create a new Heroku app:

heroku create <app-name>

and push the app to Heroku repo:

git push heroku master

sharedrop (ShareDropio/sharedrop)

Searching Database…

10.8K ·GitHub
Sharedrop
What is this?ShareDrop is a web app for sending files directly between devices over WebRTC, inspired by Apple's AirDrop, without ever uploading them to a server.
Is this a hosted service or something I run myself?The original hosted ShareDrop.io has been acquired by LimeWire, but this repo is 'ShareDrop Classic' — the same open-source code you can download and run on your own infrastructure.
How do I get it running locally?Set up a Firebase project and load firebaserules.json as its security rules, install Ember CLI globally, run yarn to install dependencies, copy .env.sample to .env, then run yarn develop to start the app.
What do I need before I can run it?A Firebase account and database for presence/WebRTC signaling, Node ^14.0.0, Ember CLI and Yarn; NEWRELIC keys are only needed for production deployments.
Does it work without internet, like AirDrop?No — ShareDrop needs an internet connection to discover other devices through Firebase signaling, unlike AirDrop which builds an ad-hoc wireless network between devices directly.
Which browsers does it support?Chrome, Edge (Chromium-based), Firefox, Opera, and Safari 13 and later.
Can I send files to someone on a different network?Yes — click the + button to create a room with a unique URL, share that URL, and anyone who opens it on their device will show up as an avatar to exchange files with, across any network.
Can I share files between a phone and a laptop?Yes, it works between mobile (Android and iOS) and desktop devices since everything happens in the browser over the same room or local network.
What happened to the original ShareDrop.io service?It was acquired by LimeWire, which now runs the hosted version with extras like end-to-end encryption and free storage; the open-source ShareDrop Classic code here remains for self-hosting.
Do I need to configure anything to use it on my home network?No — just open ShareDrop in a browser on each device sharing the same public IP address, and they will automatically detect each other.
What are similar projects?webtorrent, snapdrop, trystero, PairDrop, bitbang, WebRTC-Experiment, pooled, filepizza
Which topics is it in?yarn, heroku, peer-to-peer, firebase, file-sharing, webrtc, express, p2p, encryption, browser, web-app, npm
Creator
ShareDropio
Size
2.3 MB
Stars
10.8K
Updated
CommitFeb 10
Age
12y
Commits · 90 Days