A Progressive Web App for local file sharing

Find a file

RobinLinus 85ec77b0c4 Update README.md		2020-01-31 09:33:02 +01:00
client	Integrates docker.	2019-06-13 16:47:25 +02:00
nginx	Fixes README and spacing.	2019-06-13 16:57:48 +02:00
server	Don't crash when parsing malformed JSON	2019-05-29 21:35:39 +02:00
.gitignore	Version 2 initial commit	2018-09-21 16:05:03 +02:00
docker-compose.yml	Integrates docker.	2019-06-13 16:47:25 +02:00
LICENSE	Create LICENSE	2019-06-16 11:03:21 +02:00
README.md	Update README.md	2020-01-31 09:33:02 +01: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:

Vanilla HTML5 / ES6 / CSS3
Progressive Web App
WebRTC
WebSockets fallback
NodeJS
Material Design

Support the Snapdrop Community

Snadprop is free. Still, we have to pay the server. If you want to contribute, please use PayPal

or Bitcoin:

Thanks a lot for supporting free and open software!

Frequently Asked Questions

Instructions

Video Instructions (Big thanks to TheiTeckHq)
idownloadblog
thenextweb
winboard
免費資源網路社群

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

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

None of your files are ever sent to any server. Only between peers. Snapdrop doesn't even use a database. If you are curious have a look at the Server.

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?

File bugs, give feedback, submit suggestions
Share Snapdrop on your social media.
[Buy me a cup of coffee](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif">](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=74D2NE84JHCWG&source=url)
Fix bugs and make a pull request.
Do security analysis and suggestions

Local Development

Install docker with docker-compose.

    git clone git@github.com:RobinLinus/snapdrop.git
    cd snapdrop
    docker-compose up

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

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/default.conf.

Licences

Thanks to Mark DiAngelo for the Blop Sound

Desktop App

Note, if you are using Google Chrome you can easily install Snapdrop PWA on your desktop by clicking the install Button in the top-right corner.

If you are not using Chrome, you can install the Snapdrop Desktop App built on top of Electrum. (Thanks to Infin1tyy!).