2018-09-21 17:51:29 +00:00
# Snapdrop
2015-12-18 15:50:36 +00:00
2018-09-21 17:51:29 +00:00
[Snapdrop ](https://snapdrop.net ): local file sharing in your browser - inspired by Apple's Airdrop.
2017-01-14 20:52:52 +00:00
2018-09-24 11:14:11 +00:00
#### Snapdrop (Version 2) is built with the following awesome technologies:
2018-09-21 17:51:29 +00:00
* Vanilla HTML5 / ES6 / CSS3
* Progressive Web App
2015-12-29 00:42:01 +00:00
* [WebRTC ](http://webrtc.org/ )
* [WebSockets ](http://www.websocket.org/ ) fallback (iDevices don't support WebRTC)
* [NodeJS ](https://nodejs.org/en/ )
2016-10-08 22:28:20 +00:00
* [Material Design ](https://material.google.com/ )
2015-12-18 15:50:36 +00:00
2020-01-16 08:07:37 +00:00
## Support the Snapdrop Community
2020-01-31 08:17:35 +00:00
Snadprop is free. Still, we have to pay the server. If you want to contribute, please use PayPal
[<img src="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 )
or Bitcoin:
2020-01-16 08:10:40 +00:00
[<img src="https://coins.github.io/thx/logo-color-large-pill-320px.png" alt="CoinThx" width="200"/> ](https://coins.github.io/thx/#1K9zQ8f4iTyhKyHWmiDKt21cYX2QSDckWB?label=Snapdrop&message=Thanks!%20Your%20contribution%20helps%20to%20keep%20Snapdrop%20free%20for%20everybody! )
2018-09-21 14:12:21 +00:00
2020-01-16 08:07:37 +00:00
Thanks a lot for supporting free and open software!
## Frequently Asked Questions
2015-12-18 15:50:36 +00:00
2015-12-30 22:00:29 +00:00
### Instructions
* [Video Instructions ](https://www.youtube.com/watch?v=4XN02GkcHUM ) (Big thanks to [TheiTeckHq ](https://www.youtube.com/channel/UC_DUzWMb8gZZnAbISQjmAfQ ))
2015-12-31 01:17:02 +00:00
* [idownloadblog ](http://www.idownloadblog.com/2015/12/29/snapdrop/ )
* [thenextweb ](http://thenextweb.com/insider/2015/12/27/snapdrop-is-a-handy-web-based-replacement-for-apples-fiddly-airdrop-file-transfer-tool/ )
* [winboard ](http://www.winboard.org/artikel-ratgeber/6253-dateien-vom-desktop-pc-mit-anderen-plattformen-teilen-mit-snapdrop.html )
2018-09-24 11:14:11 +00:00
* [免費資源網路社群 ](https://free.com.tw/snapdrop/ )
2015-12-30 22:00:29 +00:00
2015-12-29 00:45:10 +00:00
##### 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).
2015-12-18 15:50:36 +00:00
2018-09-24 11:14:11 +00:00
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.
2015-12-18 15:50:36 +00:00
2015-12-29 00:45:10 +00:00
##### What about privacy? Will files be saved on third-party-servers?
None of your files are ever saved on any server.
2018-10-25 16:49:51 +00:00
Snapdrop doesn't even use a database. If you are curious have a look [at the Server ](https://github.com/RobinLinus/snapdrop/blob/master/server/ ).
2015-12-18 15:50:36 +00:00
2015-12-29 00:42:01 +00:00
##### Is SnapDrop a fork of ShareDrop?
2018-09-21 14:12:21 +00:00
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.
2018-09-24 11:14:11 +00:00
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.
2015-12-18 15:50:36 +00:00
2015-12-29 00:42:01 +00:00
### Snapdrop is awesome! How can I support it?
2016-12-07 00:30:43 +00:00
* [File bugs, give feedback, submit suggestions ](https://github.com/RobinLinus/snapdrop/issues )
2015-12-30 22:00:29 +00:00
* Share Snapdrop on your social media.
2016-01-02 01:26:47 +00:00
* [Buy me a cup of coffee ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=R9C5E42UYEQCN )
2018-09-24 11:14:11 +00:00
* Fix bugs and make a pull request.
* Do security analysis and suggestions
2015-12-18 15:50:36 +00:00
2018-09-21 14:12:21 +00:00
## Local Development
2019-06-13 14:47:25 +00:00
[Install docker with docker-compose. ](https://docs.docker.com/compose/install/ )
2018-09-21 14:12:21 +00:00
```
2019-06-13 14:57:48 +00:00
git clone git@github.com:RobinLinus/snapdrop.git
2019-06-13 14:47:25 +00:00
cd snapdrop
docker-compose up
2018-09-21 14:12:21 +00:00
```
2019-06-13 14:47:25 +00:00
Now point your browser to http://localhost:8080.
2018-09-21 14:12:21 +00:00
## 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.
2015-12-29 16:29:32 +00:00
2018-09-21 14:12:21 +00:00
By default the server listens on port 3000.
2016-01-02 13:19:11 +00:00
2019-06-13 14:57:48 +00:00
For an nginx configuration example see `nginx/default.conf` .
2016-01-02 13:19:11 +00:00
## Licences
2016-12-07 00:30:43 +00:00
* Thanks to [Mark DiAngelo]() for the [Blop Sound ](http://soundbible.com/2067-Blop.html )
2020-01-31 08:31:00 +00:00
## 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 ](https://github.com/infin1tyy/snapdrop-desktop ) built on top of Electrum. (Thanks to Infin1tyy!).