Coder Social home page Coder Social logo

arthurbergmz / snapdrop Goto Github PK

View Code? Open in Web Editor NEW

This project forked from robinlinus/snapdrop

0.0 1.0 0.0 2.94 MB

A Progressive Web App for local file sharing

Home Page: https://snapdrop.net

License: GNU General Public License v3.0

HTML 18.42% JavaScript 65.13% CSS 15.51% Dockerfile 0.08% Shell 0.86%

snapdrop's Introduction

Snapdrop

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

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

Support the Snapdrop Community

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

or Bitcoin:

CoinThx

Thanks a lot for supporting free and open software!

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

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.

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

Install docker with docker-compose.

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 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://<Your FQDN>: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://<Your FQDN>: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 storagae -> 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://<Your FQDN>: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 nginx/default.conf.

Licences

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

snapdrop's People

Contributors

azizov4singree avatar citrusui avatar dandv avatar jbyoshi avatar mmaridev avatar myfrom avatar pa7ryk avatar paulszymanski avatar remy avatar robinlinus avatar seongilp avatar sonicblis avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.