wbrawner/snapdrop
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
A Progressive Web App for local file sharing
169 commits 5 branches 0 tags 3 MiB
JavaScript 65.4%
HTML 18.3%
CSS 15.4%
Shell 0.8%
Find a file
RobinLinus b6f8d8af2e Update manifest.json
2019-03-14 00:54:12 +01:00
client Update manifest.json 2019-03-14 00:54:12 +01:00
devserver Basic File Share Target implementation 2019-03-13 18:29:45 +01:00
server Refactor and cleanup 2018-10-09 15:45:07 +02:00
.gitignore Version 2 initial commit 2018-09-21 16:05:03 +02:00
nginx.conf.example Version 2 initial commit 2018-09-21 16:05:03 +02:00
README.md Cleanup 2018-09-22 04:44:17 +02:00

README.md

Snapdrop

Snapdrop: local file sharing in your browser - inspired by Apple's Airdrop.

Snapdrop (Version 2) is built with the following awesome technologies:

Frequently Asked Questions

Instructions

What about the connection? Is it a P2P-connection directly from device to device or is there any third-party-server?

It uses a P2P connection if WebRTC is supported by the browser. (WebRTC needs a Signaling Server, but it is only used to establish a connection and is not involved in the file transfer).

If WebRTC isn’t supported (Safari, IE) it uses a Web Sockets fallback for the file transfer. The server connects the clients with each other.

What about privacy? Will files be saved on third-party-servers?

None of your files are ever saved on any server. Snapdrop doesn't even use cookies or a database. If you are curious have a look at the Server. But it does use Google Analytics.

Is SnapDrop a fork of ShareDrop?

No. ShareDrop is built with Ember. Snapdrop is built with vanilla ES6. I wanted to play around with Progressive Web Apps and then I got the idea of a local file sharing app. By doing research on this idea I found and analysed ShareDrop. I liked it and thought about how to improve it. ShareDrop uses WebRTC only and isn't compatible with Safari browsers. Snapdrop uses a Websocket fallback and some hacks to make Snapdrop work due to the download restrictions on iDevices.

Snapdrop is awesome! How can I support it?

Local Development

    git clone git@github.com:RobinLinus/snapdrop.git
    cd snapdrop/server
    npm install
    node index.js

    # open a second shell:
    cd snapdrop/client
    python -m SimpleHTTPServer

Now point your browser to http://localhost:8000.    

Deployment Notes

The client expects the server at http(s)://your.domain/server.

When serving the node server behind a proxy the X-Forwarded-For header has to be set by the proxy. Otherwise all clients that are served by the proxy will be mutually visible.

By default the server listens on port 3000.

For an nginx configuration example see nginx.conf.example.

Licences