p2pt

    1.5.0 • Public • Published

    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

    • P2Wiki: Decentralized P2P proxy to access Wikipedia
    • P2Chat: P2P noregister instant chat
    • Vett: P2P Dots-and-Boxes game. Play Here
    • WebDrop: Easily share file across devices (both LAN & over Internet)
    • Board-IO: A Simple Drawing Board that's live over P2P. Try It Out!

    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.

    Install

    npm i p2pt

    DownloadsWeekly Downloads

    23

    Version

    1.5.0

    License

    MIT

    Unpacked Size

    27.2 kB

    Total Files

    12

    Last publish

    Collaborators

    • subins2000