Skip to content

Latest commit

Β 

History

History
54 lines (34 loc) Β· 3.39 KB

README.md

File metadata and controls

54 lines (34 loc) Β· 3.39 KB

P2PT

Simple library to establish P2P connections, communicate messages using WebTorrent Trackers (WebSocket) as the signalling server. Make any kind of WebRTC app using WebTorrent trackers as general-purpose WebRTC signalling servers.

Works in both browser & node environment.

Features

  • Easy to use API
  • Send long messages: Data splitted into chunks, sent, received and reassembled all by the library !
  • Use WebSocket Trackers as signalling servers
  • JSON messaging system
  • Send & Respond to messages in a chain using Promise

How Does It Work ?

The amazing WebTorrent library created a new kind of Torrent Trackers called "WebSocket Trackers" also known as "WebTorrent Trackers". Some torrent clients can use these new trackers to share files.

Browser torrent clients (example: BTorrent) only have the capability to communicate to these WebTorrent trackers and other browser peers (known as web peers). Because, JavaScript in browser can't directly make TCP/IP connections and communicate. Read more about how WebTorrent works here.

WebRTC is the method by which browsers can communicate to other browsers peer to peer (P2P). WebTorrent makes use of WebRTC for sharing Torrents on web.

But, to establish P2P connections, a signalling server is needed. Signalling servers can be made in any way. But, you'll have to host it yourself. In WebTorrent, it's the WebSocket trackers that are the signalling servers. What if we use those trackers to establish P2P connections for our apps ?! That is what P2PT does ! :)

How do we find peers for torrent to download ? We use a magnet link. That magnet link has a unique identifier for our torrent called the Info Hash. This ID will be unique for all torrents.

Similarly, to build our apps, we use a identifier. This identifier is converted to a valid Info Hash and sent to our WebTorrent trackers who will give us a list of web peers. These web peers would be the other users also using our app :

var p2pt = new P2PT(trackersAnnounceURLs, 'myApp')

And that is how P2PT works.

Examples

Apps Built With P2PT

Add yours here ! Send a PR ! πŸš€

Simple Example

Open this webpage in two separate browser windows. You'll see the messages. It's a codepen, you can fiddle with the code there.