From 9370be23f1cf3a22d94b663e459c812cb5bc5bc1 Mon Sep 17 00:00:00 2001 From: child_duckling <19170969+child-duckling@users.noreply.github.com> Date: Sun, 13 Sep 2020 17:53:11 -0700 Subject: [PATCH 1/4] "Revamped" the docs --- docs/faq.md | 31 ++++++++++++++++++++++++++++++ docs/local-dev.md | 44 +++++++++++++++++++++++++++++++++++++++++++ docs/pwa-install.png | Bin 0 -> 36816 bytes 3 files changed, 75 insertions(+) create mode 100644 docs/faq.md create mode 100644 docs/local-dev.md create mode 100644 docs/pwa-install.png diff --git a/docs/faq.md b/docs/faq.md new file mode 100644 index 0000000..ac7f1c0 --- /dev/null +++ b/docs/faq.md @@ -0,0 +1,31 @@ +# Frequently Asked Questions + +### Instructions +* [Video Instructions](https://www.youtube.com/watch?v=4XN02GkcHUM) (Big thanks to [TheiTeckHq](https://www.youtube.com/channel/UC_DUzWMb8gZZnAbISQjmAfQ)) +* [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) +* [免費資源網路社群](https://free.com.tw/snapdrop/) + +##### 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. Files are sent only between peers. 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/). Even if Snapdrop was able to view the files being transfered, WebRTC encrypts the files on transit, so the server would be unable to read them. + +##### What about security? Are my files encrypted while being sent between the computers? +Yes. Your files are sent using WebRTC, which encrypts them on transit. + +##### Why don't you implement feature xyz? +Snapdrop is a study in radical simplicity. The user interface is insanely simple. Features are chosen very carefully because complexity grows quadratically since every feature potentially interferes with each other feature. We focus very narrowly on a single use case: instant file transfer. +We are not trying to optimize for some edge-cases. We are optimizing the user flow of the average users. Don't be sad if we decline your feature request for the sake of simplicity. + + +### Snapdrop is awesome! How can I support it? +* [Donate via PayPal to help cover the server costs](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=74D2NE84JHCWG&source=url) +* [File bugs, give feedback, submit suggestions](https://github.com/RobinLinus/snapdrop/issues) +* Share Snapdrop on your social media. +* Fix bugs and make a pull request. +* Do security analysis and suggestions + +[<- Back](/README.md) \ No newline at end of file diff --git a/docs/local-dev.md b/docs/local-dev.md new file mode 100644 index 0000000..437902c --- /dev/null +++ b/docs/local-dev.md @@ -0,0 +1,44 @@ +# Local Development +## Install + +First, [Install docker with docker-compose.](https://docs.docker.com/compose/install/) + +Then, clone the repository: +``` + git clone https://github.com/RobinLinus/snapdrop.git + cd snapdrop + docker-compose up -d +``` + +To restart the containers run `docker-compose restart`. +To stop the containers run `docker-compose stop`. + + +Now point your browser to `http://localhost:8080`. + +## Testing PWA related features +PWAs require that the app is served under a correctly set up and trusted TLS endpoint. + +The nginx container creates a CA certificate and a website certificate for you. To correctly set the common name of the certificate, you need to change the FQDN environment variable in `docker/fqdn.env` to the fully qualified domain name of your workstation. + +If you want to test PWA features, you need to trust the CA of the certificate for your local deployment. For your convenience, you can download the crt file from `http://:8080/ca.crt`. Install that certificate to the trust store of your operating system. +- On Windows, make sure to install it to the `Trusted Root Certification Authorities` store. +- On MacOS, double click the installed CA certificate in `Keychain Access`, expand `Trust`, and select `Always Trust` for SSL. +- Firefox uses its own trust store. To install the CA, point Firefox at `http://:8080/ca.crt`. When prompted, select `Trust this CA to identify websites` and click OK. +- When using Chrome, you need to restart Chrome so it reloads the trust store (`chrome://restart`). Additionally, after installing a new cert, you need to clear the Storage (DevTools -> Application -> Clear storage -> Clear site data). + +Please note that the certificates (CA and webserver cert) expire after a day. +Also, whenever you restart the nginx docker, container new certificates are created. + +The site is served on `https://:443`. +     +## 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 `docker/nginx/default.conf`. + +[< Back](/README.md) \ No newline at end of file diff --git a/docs/pwa-install.png b/docs/pwa-install.png new file mode 100644 index 0000000000000000000000000000000000000000..f53d8a840d25437c70a21d1443d4cb7db3ca4ebc GIT binary patch literal 36816 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 QkAcI~(A=P2&*ky|0EE>nY5)KL literal 0 HcmV?d00001 From 03ec4ebdac8349978445a2dee4e40fbc765bdae5 Mon Sep 17 00:00:00 2001 From: child_duckling <19170969+child-duckling@users.noreply.github.com> Date: Sun, 13 Sep 2020 17:56:12 -0700 Subject: [PATCH 2/4] Revamped docs (v2) --- README.md | 80 ++++++----------------------------------------- client/index.html | 2 +- docs/faq.md | 14 ++++++--- 3 files changed, 19 insertions(+), 77 deletions(-) diff --git a/README.md b/README.md index 6dac5d3..36ef752 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,7 @@ [Snapdrop](https://snapdrop.net): local file sharing in your browser. Inspired by Apple's Airdrop. + #### Snapdrop is built with the following awesome technologies: * Vanilla HTML5 / ES6 / CSS3 * Progressive Web App @@ -10,8 +11,10 @@ * [NodeJS](https://nodejs.org/en/) * [Material Design](https://material.google.com/) +> If you want to self-host your own instance, [you can with docker.](/docs/local-dev) + ## Support the Snapdrop Community -Snadprop is free. Still, we have to pay for the server. If you want to contribute, please use PayPal: +Snapdrop is free. Still, we have to pay for the server. If you want to contribute, please use PayPal: [](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=74D2NE84JHCWG&source=url) @@ -24,80 +27,15 @@ Alternatively, you can become a [Github Sponsor](https://github.com/sponsors/Rob Thanks a lot for supporting free and open software! -## Frequently Asked Questions - -### Instructions -* [Video Instructions](https://www.youtube.com/watch?v=4XN02GkcHUM) (Big thanks to [TheiTeckHq](https://www.youtube.com/channel/UC_DUzWMb8gZZnAbISQjmAfQ)) -* [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) -* [免費資源網路社群](https://free.com.tw/snapdrop/) - -##### 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. Files are sent only between peers. 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/). Even if Snapdrop was able to view the files being transfered, WebRTC encrypts the files on transit, so the server would be unable to read them. - -##### What about security? Are my files encrypted while being sent between the computers? -Yes. Your files are sent using WebRTC, which encrypts them on transit. - -##### Why don't you implement feature xyz? -Snapdrop is a study in radical simplicity. The user interface is insanely simple. Features are chosen very carefully because complexity grows quadratically since every feature potentially interferes with each other feature. We focus very narrowly on a single use case: instant file transfer. -We are not trying to optimize for some edge-cases. We are optimizing the user flow of the average users. Don't be sad if we decline your feature request for the sake of simplicity. +> Have any questions? You can read our [faq](/docs/faq) -### Snapdrop is awesome! How can I support it? -* [Donate via PayPal to help cover the server costs](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=74D2NE84JHCWG&source=url) -* [File bugs, give feedback, submit suggestions](https://github.com/RobinLinus/snapdrop/issues) -* Share Snapdrop on your social media. -* Fix bugs and make a pull request. -* Do security analysis and suggestions -## Local Development -[Install docker with docker-compose.](https://docs.docker.com/compose/install/) +## Apps +1. [Snapdrop PWA](/docs/faq) -Clone the repository: -``` - git clone https://github.com/RobinLinus/snapdrop.git - cd snapdrop - docker-compose up -d -``` + 1. [Snapdrop Desktop App](https://github.com/infin1tyy/snapdrop-desktop) built on top of Electron. (Thanks to [Infin1tyy!](https://github.com/infin1tyy/)). -To restart the containers run `docker-compose restart`. -To stop the containers run `docker-compose stop`. - - -Now point your browser to `http://localhost:8080`. - -### Testing PWA related features -PWAs require that the app is served under a correctly set up and trusted TLS endpoint. - -The nginx container creates a CA certificate and a website certificate for you. To correctly set the common name of the certificate, you need to change the FQDN environment variable in `docker/fqdn.env` to the fully qualified domain name of your workstation. - -If you want to test PWA features, you need to trust the CA of the certificate for your local deployment. For your convenience, you can download the crt file from `http://:8080/ca.crt`. Install that certificate to the trust store of your operating system. -- On Windows, make sure to install it to the `Trusted Root Certification Authorities` store. -- On MacOS, double click the installed CA certificate in `Keychain Access`, expand `Trust`, and select `Always Trust` for SSL. -- Firefox uses its own trust store. To install the CA, point Firefox at `http://:8080/ca.crt`. When prompted, select `Trust this CA to identify websites` and click OK. -- When using Chrome, you need to restart Chrome so it reloads the trust store (`chrome://restart`). Additionally, after installing a new cert, you need to clear the Storage (DevTools -> Application -> Clear storage -> Clear site data). - -Please note that the certificates (CA and webserver cert) expire after a day. -Also, whenever you restart the nginx docker, container new certificates are created. - -The site is served on `https://:443`. -     -## 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 `docker/nginx/default.conf`. - -## 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 or Edge, you can install the [Snapdrop Desktop App](https://github.com/infin1tyy/snapdrop-desktop) built on top of Electron. (Thanks to Infin1tyy!). + 1. Feel free to make one :) diff --git a/client/index.html b/client/index.html index ff0ebe8..41e8338 100644 --- a/client/index.html +++ b/client/index.html @@ -141,7 +141,7 @@ - + diff --git a/docs/faq.md b/docs/faq.md index ac7f1c0..c4a8e67 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -7,16 +7,20 @@ * [winboard](http://www.winboard.org/artikel-ratgeber/6253-dateien-vom-desktop-pc-mit-anderen-plattformen-teilen-mit-snapdrop.html) * [免費資源網路社群](https://free.com.tw/snapdrop/) -##### What about the connection? Is it a P2P-connection directly from device to device or is there any third-party-server? +### Help! I can't install the PWA! +if you are using a Chromium-based browser (Chrome, Edge, Brave, etc.), you can easily install Snapdrop PWA on your desktop by clicking the install button in the top-right corner while on [snapdrop.net](https://snapdrop.net) (see below). + + +### 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? +### What about privacy? Will files be saved on third-party-servers? None of your files are ever sent to any server. Files are sent only between peers. 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/). Even if Snapdrop was able to view the files being transfered, WebRTC encrypts the files on transit, so the server would be unable to read them. -##### What about security? Are my files encrypted while being sent between the computers? +### What about security? Are my files encrypted while being sent between the computers? Yes. Your files are sent using WebRTC, which encrypts them on transit. -##### Why don't you implement feature xyz? +### Why don't you implement feature xyz? Snapdrop is a study in radical simplicity. The user interface is insanely simple. Features are chosen very carefully because complexity grows quadratically since every feature potentially interferes with each other feature. We focus very narrowly on a single use case: instant file transfer. We are not trying to optimize for some edge-cases. We are optimizing the user flow of the average users. Don't be sad if we decline your feature request for the sake of simplicity. @@ -28,4 +32,4 @@ We are not trying to optimize for some edge-cases. We are optimizing the user fl * Fix bugs and make a pull request. * Do security analysis and suggestions -[<- Back](/README.md) \ No newline at end of file +[< Back](/README.md) \ No newline at end of file From 5fe584bb0dc6a4cafabef5c4318a7928e5fc1d8d Mon Sep 17 00:00:00 2001 From: child_duckling <19170969+child-duckling@users.noreply.github.com> Date: Sun, 13 Sep 2020 17:57:30 -0700 Subject: [PATCH 3/4] Caught a mistake --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 36ef752..0815986 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,7 @@ Alternatively, you can become a [Github Sponsor](https://github.com/sponsors/Rob Thanks a lot for supporting free and open software! -> Have any questions? You can read our [faq](/docs/faq) +> Have any questions? You can read our [FAQ](/docs/faq) From a5baea1a72ee74bb8da419c4c9a3d64254126428 Mon Sep 17 00:00:00 2001 From: child_duckling <19170969+child-duckling@users.noreply.github.com> Date: Sun, 13 Sep 2020 17:58:55 -0700 Subject: [PATCH 4/4] mistake --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 36ef752..1a6e157 100644 --- a/README.md +++ b/README.md @@ -11,7 +11,7 @@ * [NodeJS](https://nodejs.org/en/) * [Material Design](https://material.google.com/) -> If you want to self-host your own instance, [you can with docker.](/docs/local-dev) +> If you want to self-host your own instance, [you can with docker.](/docs/local-dev.md) ## Support the Snapdrop Community Snapdrop is free. Still, we have to pay for the server. If you want to contribute, please use PayPal: @@ -27,7 +27,7 @@ Alternatively, you can become a [Github Sponsor](https://github.com/sponsors/Rob Thanks a lot for supporting free and open software! -> Have any questions? You can read our [faq](/docs/faq) +> Have any questions? You can read our [faq](/docs/faq.md)